Cleanup Deals
Find past-due, stale, incomplete, unexplained-loss, and likely test deals, then route each owner's flagged deals to them as one review task. Never bulk-closes deals; deletes only test deals a person marked in a reviewed CSV. Skips Salesforce-synced deals.
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-dealsgit 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-deals ~/.claude/skills/cleanup-dealsPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Cleanup Deals Standardize deal data to make pipeline reporting accurate. Test deals, missing amounts, and stale opportunities distort forecasts and pipeline metrics. The fix for most bad deal data is a decision only the deal owner can make: is this deal alive, what is it worth, when will it close, why was it lost. So the scripted path here finds the problems precisely and puts them in front of the right person. It does not make those decisions for them. ## Prerequisites - A HubSpot service key (`HUBSPOT_ACCESS_TOKEN` in `.env`; an existing legacy private app token also works) with: - `crm.objects.deals.read` and `crm.objects.owners.read` (all stages) - `crm.objects.contacts.write` (HubSpot gates task creation on it; review-task mode only) - `crm.objects.deals.write` (reviewed-deletion mode only) - Python 3.10+ with [`uv`](https://github.com/astral-sh/uv) - Knowledge of which deal pipelines are active and which are synced from Salesforce ## Important: Salesforce Sync Considerations If deals are synced from Salesforce: - Do NOT delete or modify synced deals without coordinating with the Salesforce admin. - Changes in HubSpot may sync back to Salesforce and cause data loss. - Identify synced deals by checking for the `hs_salesforceopportunityid` property.
Details
- Skill name
cleanup-deals- Repository
- TomGranot/hubspot-admin-skills
- Path
skills/cleanup-deals/SKILL.md- License
- MIT
- Repo updated
- 10 November 2026
- Listed in
- BehiSecc/awesome-claude-skills
FAQ
What does the Cleanup Deals skill do?
Find past-due, stale, incomplete, unexplained-loss, and likely test deals, then route each owner's flagged deals to them as one review task. Never bulk-closes deals; deletes only test deals a person marked in a reviewed CSV. Skips Salesforce-synced deals.
How do I install the Cleanup Deals 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 Deals 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.
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.
PR Test Plan
49pixelfrog7523-vgfvu/pr-test-plan
From a PR description or diff summary, produce a practical test plan: risks, cases, regression, data setup. Triggers: PR test plan, test plan, QA checklist, pull request testing, regression list. 中文:根据 PR/变更说明产出测试计划(风险、用例、回归、数据)。触发词:PR 测试计划、测试清单、回归列表。
Cleanup Properties
81TomGranot/hubspot-admin-skills
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.
Browse the most popular Claude skills, all testing & qa skills, or write your own with the skills generator.