Cleanup Properties
Archive or delete unused custom properties across all HubSpot object types (contacts, companies, deals). Identifies Salesforce sync properties, test/temp properties, and obsolete form fields.
Install
/plugin marketplace add TomGranot/hubspot-admin-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add TomGranot/hubspot-admin-skills --skill cleanup-propertiesgit clone --depth 1 https://github.com/TomGranot/hubspot-admin-skills.git /tmp/hubspot-admin-skills
mkdir -p ~/.claude/skills
cp -r /tmp/hubspot-admin-skills/skills/cleanup-properties ~/.claude/skills/cleanup-propertiesPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Cleanup Properties
Remove or archive unused custom properties. Property bloat slows down forms, confuses users, and makes data mapping harder.
## Prerequisites
- A HubSpot service key (`HUBSPOT_ACCESS_TOKEN` in `.env`; an existing legacy private app token also works) with `crm.schemas.*.read` and `crm.schemas.*.write` scopes
- Python 3.10+ with [`uv`](https://github.com/astral-sh/uv)
## Step-by-Step Instructions
### Stage 1: Plan
Confirm with the user before starting:
1. Archive-first policy (recommended) or direct deletion for clearly dead test properties?
2. Is a Salesforce (or other CRM) sync active? If yes, get the sync property mapping before touching anything.
### Stage 2: Before
Inventory custom properties for each object type via the Properties API (v3):
```python
import os, requests
from dotenv import load_dotenv
load_dotenv()
TOKEN = os.environ["HUBSPOT_ACCESS_TOKEN"]
BASE = "https://api.hubapi.com"
HEADERS = {"Authorization": f"Bearer {TOKEN}", "Content-Type": "application/json"}
for obj_type in ["contacts", "companies", "deals"]:
resp = requests.get(f"{BASE}/crm/v3/properties/{obj_type}", headers=HEADERS)
resp.raise_for_status()
custom_props = [p for p in resp.json()["results"] if not p.get("hubspotDefined")]
```
For each custom property, record: name, label, object type, type, group, number of records with a value (requires search queries), whether it is used in any form/workflow/list.
### Stage 3: Execute
**Safe to delete:**Details
- Skill name
cleanup-properties- Repository
- TomGranot/hubspot-admin-skills
- Path
skills/cleanup-properties/SKILL.md- License
- MIT
- Repo updated
- 10 November 2026
- Listed in
- BehiSecc/awesome-claude-skills
FAQ
What does the Cleanup Properties skill do?
Archive or delete unused custom properties across all HubSpot object types (contacts, companies, deals). Identifies Salesforce sync properties, test/temp properties, and obsolete form fields.
How do I install the Cleanup Properties skill?
Claude Code plugin: /plugin marketplace add TomGranot/hubspot-admin-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Cleanup Properties popular?
It lives in TomGranot/hubspot-admin-skills, which has 81 GitHub stars and 19 forks, and is included in 1 curated skill list.
Related skills
Assign Unowned Contacts
81TomGranot/hubspot-admin-skills
Assign an owner to marketing contacts that have no owner. Ensures every marketable contact has accountability for follow-up, proper lead routing, and accurate owner-based reporting.
Audit API Usage
81TomGranot/hubspot-admin-skills
Inventory the integrations, service keys, legacy private apps, and internal tooling that call HubSpot APIs, and flag anything on legacy v1-v4 endpoints or legacy app architecture ahead of HubSpot's 2027 cutoffs. Produces a migration checklist to date-based API versions and service keys.
Backfill Geo Data
81TomGranot/hubspot-admin-skills
Enrich missing geographic data (country, state, city) on contacts and companies using HubSpot workflows, external data providers, or IP-based geolocation.
Device Class Authoring
44netdisco/snmp-info
Use when adding or changing an SNMP::Info device class (lib/SNMP/Info/Layer*/Vendor.pm), its detection in device_type(), its tests or its POD, or when choosing between a standard MIB and a vendor MIB for a method.
Cleanup Forms
81TomGranot/hubspot-admin-skills
Audit and remove unused, test, or deprecated forms from HubSpot. Identifies forms with zero submissions, forms not embedded on any page, and test forms left over from development.
Sandbox Self Test
81TomGranot/hubspot-admin-skills
Verify the entire toolkit against a disposable HubSpot developer test account or sandbox that you bring: seed synthetic fixtures, run every scripted skill's read path, exercise end-to-end and API round-trip cases, produce a graded report, and tear everything down. Hard-refuses to run against production.
Browse the most popular Claude skills, all testing & qa skills, or write your own with the skills generator.