cleanup-forms
Installation
SKILL.md
Cleanup Forms
Audit HubSpot forms to remove unused and test forms. Stale forms clutter the forms dashboard and can cause confusion when building workflows or reports.
Prerequisites
- A HubSpot private app access token (
HUBSPOT_ACCESS_TOKENin.env) withformsscope - Python 3.10+ with
uv - Note: The Forms API may return 403 on some plan tiers. If so, perform the audit manually in the HubSpot UI under Marketing > Forms.
Step-by-Step Instructions
Stage 1: Plan
Confirm with the user before starting:
- How aggressive to be: delete outright, or prefix with "[DEPRECATED]" first and delete next quarter?
- Any forms that must never be touched (compliance, legal, active campaigns)?