Cleanup Lists
技能 活跃Audit and remove unused, empty, or duplicate list definitions from HubSpot. Identifies lists with zero members, lists not used by any workflow or email, and overlapping list criteria.
To streamline HubSpot CRM administration by automating the cleanup of redundant and unutilized list definitions, improving portal performance and data clarity.
功能
- Audits lists for zero members, inactivity, duplication, and test/temp naming.
- Identifies lists not used by workflows, emails, or ad audiences.
- Provides step-by-step instructions for deletion and documentation.
- Includes considerations for rollback and prevention of future clutter.
使用场景
- Cleaning up a cluttered HubSpot portal with many unused lists.
- Improving system performance by removing obsolete list definitions.
- Ensuring data accuracy and reducing confusion among marketing and sales teams.
- Establishing a quarterly routine for HubSpot data hygiene.
非目标
- Deleting lists that are actively used or critical for segmentation.
- Performing actions on HubSpot objects other than list definitions.
- Providing real-time deletion without user review and confirmation.
Documentation
- warning:Configuration & parameter referenceThe SKILL.md mentions a HubSpot API token in `.env` but does not explicitly document this requirement or its format, nor does it mention the Python dependencies requiring `uv` installation in detail.
Maintenance
- warning:Dependency ManagementThe skill relies on Python and the `hubspot-api-client` but does not specify version constraints or a lockfile for Python dependencies, only mentioning installation via `uv`.
Security
- warning:Secret ManagementThe skill requires a HubSpot API token from a `.env` file, which is a common practice, but the documentation could be more explicit about the token's scope and the security implications of storing it.
- warning:Unguarded Destructive OperationsThe 'Delete and Document' stage of the workflow involves deleting HubSpot lists via API calls, which is a destructive operation. While the skill outlines reviewing and confirming before deletion, explicit confirmation prompts or dry-run modes are not detailed in the script execution part.
Trust
- info:Issues AttentionIn the last 90 days, 0 issues were opened and 1 was closed. This suggests low current activity or that issues are promptly addressed when they arise.
Code Execution
- info:ValidationThe Python script interacts with the HubSpot API, which likely performs its own validation. However, the script itself does not explicitly detail input validation or sanitization beyond what the API client might enforce.
- info:Error HandlingThe Python script includes a `try...except` block for API calls, which is good practice. However, the specific error handling for API responses (e.g., rate limits, specific error codes) and script execution failures could be more detailed, with clearer remediation steps.
- info:LoggingThe script mentions exporting data to CSV in Stage 1, which serves as a form of audit logging for the initial state. However, there is no explicit mention of a persistent audit log file for actions taken by the skill.
Portability
- info:Runtime stabilityThe skill assumes a Python environment with specific libraries (`hubspot-api-client`) and relies on the HubSpot API, which is a standard setup. It doesn't explicitly detail cross-OS compatibility beyond standard Python execution.
- info:Stack assumptionsThe skill assumes a Python 3.10+ environment with `uv` and the `hubspot-api-client` library. While mentioned in prerequisites, the specific interpreter and version assumptions are not explicitly declared with shebangs or headers as would be typical for standalone scripts.
Install
- warning:Installation instructionWhile installation instructions are provided in the README for the marketplace, the specific prerequisite of installing Python dependencies via `uv` and obtaining a HubSpot API token with appropriate scopes could be more detailed and actionable within the SKILL.md itself.
Errors
- info:Actionable error messagesThe skill mentions documenting what was deleted in a log, and the Python script includes basic error handling. However, specific user-facing error messages with remediation steps for API failures or script execution issues are not explicitly detailed.
Execution
- warning:Pinned dependenciesThe skill mentions installing Python dependencies via `uv` but does not provide specific version pinning for the `hubspot-api-client` or other Python packages, which could lead to compatibility issues.
Scope
- warning:Dry-run previewThe skill outlines a deletion process but does not explicitly offer a `--dry-run` mode or equivalent parameter for the Python script to preview the deletions before execution.
Protocol
- info:Idempotent retry & timeoutsThe Python script uses the `hubspot-api-client`, which may handle retries and timeouts internally. However, this is not explicitly documented or guaranteed within the skill's instructions, and the deletion operation is not described as inherently idempotent.
Practical Utility
- info:Edge casesThe skill mentions that the Lists API may return 403 on some plan tiers, suggesting a potential failure mode. It also notes that HubSpot has no list recycle bin, implying a critical failure mode if deletion is unintentional.
Safety
- warning:Halt on unexpected stateWhile the skill stresses cross-referencing with workflows before deleting, it does not explicitly state a machine-readable checklist for pre-conditions or instruct to abort on unexpected states like a dirty working tree or drifted schema.
安装
请先添加 Marketplace
/plugin marketplace add TomGranot/hubspot-admin-skills/plugin install hubspot-admin-skills@hubspot-admin-skills质量评分
类似扩展
Lifecycle Progression Workflow
100Build workflows to automate contact progression through the sales funnel: Lead to MQL to SQL to Opportunity to Customer. Each transition is triggered by a specific event (score threshold, meeting booked, deal created, deal won).
Cleanup Dashboards
100Audit and consolidate HubSpot reporting dashboards. Identifies unused, duplicate, or outdated dashboards. Must be performed manually — no dashboard API is available.
Reassign Deactivated Owners
99Reassign contacts and companies from deactivated team members to active owners. Fully automated via the HubSpot Owners API and Batch Update API. Includes territory analysis for informed reassignment decisions.
Enrich Contact Industry
99Backfill contact-level industry from associated company records using a HubSpot workflow. Enables industry-based segmentation for targeted campaigns aligned with ICP verticals.
Weekly Cleanup Routine
98A lightweight 5-minute weekly health check covering bounce monitoring, new contact quality, workflow health, list growth trends, and data quality sampling. Quick early warning system, not a comprehensive audit.
Review Bounced Contacts
98Weekly manual review of contacts with 3+ bounce events. Decide whether to delete or attempt recovery for each flagged contact. Prevents over-suppression while removing truly bad data.