Community
Help build the skill set
Every portal breaks differently. When the audit finds an issue no skill covers, it can write the skill and contribute it back.
The automatic way
Run /hubspot-audit. When it detects an issue no existing skill covers, it offers to create one and asks:
"Would you like to contribute this new skill back to the community? It will help other HubSpot admins facing the same issue."
Say yes and Claude Code writes the skill, pushes it to your fork, and opens the pull request. You never touch git or markdown. When the PR merges, the skill gets its pages on this site without anyone lifting a finger.
The manual way
Fork & branch
Fork the repo and create a branch: skill/your-skill-name
Create the skill
Add skills/<your-skill>/SKILL.md with YAML frontmatter (name, description, license, metadata) and the 4-stage pattern: Plan → Before → Execute → After. Include safety mechanisms and rollback instructions.
Test against a sandbox
Run the skill end-to-end against a HubSpot sandbox portal before submitting.
Open a pull request
The site build validates your frontmatter. A malformed skill fails the deploy preview, so you find out in minutes, not in review.
Skill categories
Assign your skill to one of these categories in the metadata.category frontmatter field:
| Category | Slug | Description |
|---|---|---|
| Audit & Planning | audit-planning | Portal assessment, connectivity, and implementation planning. |
| Database Hygiene | database-hygiene | Removing bad data, suppressing contacts, deduplication. |
| Data Enrichment | data-enrichment | Filling gaps in contact and company data. |
| Segmentation & Scoring | segmentation-scoring | ICP tiers, lead scoring, smart lists. |
| Automation Workflows | automation-workflows | HubSpot workflows for ongoing hygiene. |
| Ongoing Maintenance | ongoing-maintenance | Recurring cleanup and health checks. |
Please keep skills generic and company-agnostic — no customer data, API keys, or proprietary information.