gt-hubspot-admin

Automates HubSpot CRM administration through 68 playbooks covering audits, hygiene, pipelines, and workflows.

3|2|Updated Jul 9, 2026
One-click install
npx skills add https://github.com/Growth-Today/claude-skills --skill gt-hubspot-admin-growth-today
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gt-hubspot-admin
Source: https://github.com/Growth-Today/claude-skills/tree/main/gt-hubspot-admin
Command: npx skills add https://github.com/Growth-Today/claude-skills --skill gt-hubspot-admin-growth-today

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, python-dotenv, hubspot-api-client, and includes scripts (resource) components.

What problem does it solve? HubSpot portals accumulate duplicate records, bounced contacts, broken lifecycle stages, and misconfigured pipelines that inflate billing costs and damage sender reputation. This Skill routes any HubSpot administration request to the right playbook and executes cleanup, enrichment, segmentation, automation, and governance tasks with API-backed scripts and step-by-step UI instructions. ## Core Features & Use Cases - Full-Portal Audit & Planning: Run a read-only diagnostic across 8 dimensions (database size, deliverability, completeness, engagement, duplicates, owner health, lists/workflows, deal pipeline) and generate a phased implementation plan with effort estimates and dependencies. - Data Hygiene & Suppression: Suppress hard-bounced, unsubscribed, and ghost contacts, merge duplicate companies, reassign deactivated owners, and manage marketing-contact status to reduce billing waste. - Segmentation, Pipelines & Automation: Build smart lists, ICP tiers, lead scoring, deal pipelines, and workflows (bounce monitoring, lifecycle progression, engagement suppression) with manual UI, Breeze AI, or Chrome extension build options. - Use Case: Ask for a HubSpot audit; the Skill runs Python scripts against the HubSpot REST API, writes raw metrics to reports/audit-raw.json, then produces a prioritized 5-phase cleanup roadmap referencing the exact playbooks to run. ## Quick Start Ask Claude to audit my HubSpot portal and generate a prioritized cleanup implementation plan.

Frequently Asked Questions about gt-hubspot-admin

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit a HubSpot portal for data quality issues?▼

Run the hubspot-audit playbook, which executes read-only Python scripts against the HubSpot REST API across 8 dimensions including deliverability, completeness, engagement, duplicates, and owner health. Results are written to reports/audit-raw.json and graded per dimension.

How do I suppress hard bounced contacts in HubSpot?▼

Use the suppress-hard-bounced playbook, which follows a hybrid approach: a script sets a custom flag property via the API, then a HubSpot workflow triggers on that flag to set the contact as non-marketing. This is required because hs_marketable_status is read-only via the API.

Can HubSpot workflows be created via the API?▼

No, the HubSpot Workflows API v4 is beta and unstable, so the playbooks do not create workflows programmatically. Instead they offer three build options: manual UI steps, HubSpot Breeze AI prompts, or the Claude Chrome extension driving the workflow builder.

What permissions and setup does this HubSpot skill require?▼

You need a HubSpot private app access token stored as HUBSPOT_ACCESS_TOKEN in a .env file, plus Python 3.10+ with requests, python-dotenv, and hubspot-api-client installed. Required HubSpot scopes vary by playbook, and some features need Marketing or Operations Hub Professional tiers.

Why can't I set a contact to an earlier lifecycle stage in HubSpot?▼

HubSpot enforces forward-only lifecycle stage progression. To move a contact backward, the playbooks first clear the property with an empty string via API, then set the desired earlier stage in a second API call.

Does this skill work with Salesforce or other CRMs?▼

No, it is explicitly scoped to HubSpot portal administration only and its frontmatter states it should not be used for Salesforce, Pipedrive, or other CRMs. All scripts target the HubSpot REST API at api.hubapi.com.