Cleanup Properties
Skill ActiveArchive or delete unused custom properties across all HubSpot object types (contacts, companies, deals). Identifies Salesforce sync properties, test/temp properties, and obsolete form fields.
To help HubSpot administrators maintain CRM hygiene by identifying and removing or archiving unused custom properties, thereby reducing data bloat and improving usability.
Features
- Archives or deletes unused custom properties
- Supports contacts, companies, and deals object types
- Identifies Salesforce sync properties
- Detects test/temp/obsolete properties
- Provides step-by-step instructions for cleanup
Use Cases
- When custom properties have become obsolete and are no longer used
- To clean up properties created for testing or temporary purposes
- To manage HubSpot's property limits by removing unused fields
- As part of a regular CRM data hygiene routine
Non-Goals
- Deleting custom properties that are actively in use
- Managing HubSpot standard properties
- Modifying properties associated with active Salesforce syncs without coordination
- Restoring permanently deleted properties
Documentation
- warning:Configuration & parameter referenceWhile prerequisites mention a HubSpot API token in .env and Python installation via uv, the specific parameters for the script execution and their potential defaults are not explicitly documented.
Maintenance
- warning:Dependency ManagementThe skill lists 'Python with hubspot-api-client installed via uv' as a prerequisite, but does not provide a lockfile or explicit version pinning for these dependencies.
Security
- warning:Secret ManagementThe skill requires a HubSpot API token in `.env` but does not explicitly detail how this token is secured or if it's ever logged or exposed in output.
- warning:Unguarded Destructive OperationsThe skill's execute stage involves deleting or archiving HubSpot properties, which are destructive operations. While it suggests archiving first and waiting 30 days, there is no explicit confirmation prompt or dry-run mode documented before executing deletions.
Code Execution
- warning:ValidationThe Python script iterates through properties but does not show explicit schema validation for API inputs or outputs, nor sanitization of the fetched property data.
- warning:Error HandlingThe Python script shows basic iteration but lacks explicit error handling for API calls or unexpected data structures, potentially leading to silent failures or opaque error messages.
- warning:LoggingThere is no mention or implementation of a local audit log for the actions performed by the Python script.
Errors
- warning:Actionable error messagesThe SKILL.md mentions potential failure modes and recovery steps, but the provided Python script snippets lack explicit error handling that would surface actionable messages to the user.
Execution
- warning:Pinned dependenciesThe prerequisite mentions 'Python with hubspot-api-client installed via uv', but no specific versions or lock files are provided, leaving dependency versions unpinned.
Scope
- warning:Dry-run previewThe skill involves deleting or archiving properties, which are destructive operations, but no `--dry-run` flag or equivalent preview mechanism is described or implemented.
Practical Utility
- info:Usage examplesWhile the SKILL.md provides code snippets for stages 1 and 2, a fully runnable end-to-end example demonstrating invocation and observable output for the entire cleanup process is missing.
- warning:Edge casesThe SKILL.md names failure modes like 'deleted properties cannot be restored' and Salesforce sync properties, but lacks explicit documentation on handling malformed input, API rate limits, or other common error scenarios with recovery steps.
Safety
- warning:Halt on unexpected stateThe SKILL.md does not explicitly list preconditions for running the script, such as a clean working tree or schema checks, nor does it detail how to halt and report on unexpected pre-state.
Installation
First, add the marketplace
/plugin marketplace add TomGranot/hubspot-admin-skills/plugin install hubspot-admin-skills@hubspot-admin-skillsQuality Score
Trust Signals
Similar Extensions
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.
Context Mode Purge
99Purge the context-mode knowledge base. Permanently deletes all indexed content and resets session stats. This is destructive and cannot be undone. Trigger: /context-mode:ctx-purge
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.