HubSpot Context Pack
andrewm621/hubspot-context-pack
Injeção contextual de 17 skills HubSpot para desenvolvimento integrado
Ver no GitHubPlugin Claude Code que injeta automaticamente conhecimento sobre APIs e plataforma HubSpot em contexto, cobrindo autenticação, CRM, automações e integrações. Ativa skills relevantes detectando arquivos, comandos CLI e prompts relacionados ao HubSpot, eliminando pesquisas manuais de documentação.
Instalação
npx convez-ai andrewm621/hubspot-context-pack1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Desenvolvimento de integrações e APIs com HubSpot
- Automação de fluxos de trabalho e webhooks
- Gestão de contatos, empresas e deals via código
Veredito

Solução bem-estruturada de knowledge injection que reduz fricção em projetos HubSpot. Abrange domínios críticos (auth, CRM core, workflows) com padrões práticos em TypeScript, mas depende de manutenção contínua para acompanhar mudanças de API.
README
A tradução para o português deste README ainda está na fila.
strata_id: eb24fc78-4a39-436f-ba84-69c9b580990b type: note created: 2026-05-03T19:00:53+00:00 modified: 2026-05-03T19:00:53.883786653+00:00
HubSpot Context Pack
A Claude Code plugin that provides AI-consumable knowledge about the HubSpot platform and APIs. When you're working with HubSpot files, running CLI commands, or discussing HubSpot topics, relevant guidance is automatically injected into your conversation.
Installation
claude plugin add /path/to/hubspot-context-pack
Or from GitHub (once published):
claude plugin add github:andrewm621/hubspot-context-pack
How It Works
The plugin uses Claude Code's hook system to automatically inject relevant HubSpot knowledge:
-
Session Start — Injects the HubSpot platform knowledge graph (
hubspot.md) with API architecture, object model, and decision matrices. Detects HubSpot project markers (config files, SDK imports, env vars) to prioritize relevant skills. -
File Operations — When you read, edit, or write files matching HubSpot patterns (e.g.,
hubspot.config.yml, contact/deal handler files), the relevant skill is injected. -
Bash Commands — When you run HubSpot CLI commands or API calls, matching skills are injected.
-
Prompt Matching — When you ask about HubSpot topics, relevant skills are injected based on keyword matching.
Skills
17 skills covering the HubSpot platform domains a developer actually touches:
Tier 1 — Core (Priority 8)
| Skill | Domain | Key Topics |
|---|---|---|
hubspot-auth | Authentication | Private Apps, OAuth 2.0, scopes, token refresh |
contacts | CRM Contacts | CRUD, search, properties, lists, associations |
Tier 1 — Core (Priority 7)
| Skill | Domain | Key Topics |
|---|---|---|
companies | CRM Companies | CRUD, search, domains, associations |
deals | CRM Deals | CRUD, pipelines, stages, associations |
custom-objects | Custom Objects | Schema definition, properties, associations |
Tier 2 — Extended (Priority 5-6)
| Skill | Domain | Key Topics |
|---|---|---|
workflows | Automation | Triggers, actions, branching, custom code |
webhooks | Webhooks | Subscriptions, verification, retry policy |
associations | Associations | Types, labels, batch operations, schemas |
properties | Properties | Custom properties, groups, options, calculated |
tickets | Service Hub | Pipelines, SLAs, support ticket management |
email-marketing | Transactional, marketing, subscriptions | |
forms | Forms | Submission API, fields, progressive profiling |
lists | Lists | Static vs active, membership, segmentation |
Tier 3 — Specialized (Priority 4)
| Skill | Domain | Key Topics |
|---|---|---|
cms | CMS Hub | Pages, blog, HubDB, templates, HubL |
reporting | Analytics | Reports, attribution, traffic analytics |
conversations | Conversations | Inbox, threads, chat, custom channels |
crm-extensions | UI Extensions | CRM cards, timeline events, calling |
Skill Format
Each skill follows a 6-section structure:
- What It Is & When to Use It — 2-3 sentence orientation
- Service Surface — Endpoints, rate limits, required scopes (table format)
- Mental Model — 3-5 conceptual primitives
- Common Patterns — Recipes with TypeScript code using
@hubspot/api-client - Gotchas — Real rate limit traps, quirks, deprecated behaviors, common mistakes
- Official Documentation — Authoritative links only
Development
# Generate skill manifest (speeds up hook execution)
node scripts/build-manifest.mjs
# Validate all skills
node scripts/validate.mjs
# Generate skill catalog
node scripts/generate-catalog.mjs
Configuration
| Environment Variable | Default | Description |
|---|---|---|
HUBSPOT_PLUGIN_HOOK_DEDUP | (enabled) | Set to off to re-inject skills each time |
HUBSPOT_PLUGIN_LIKELY_SKILLS | (auto-detected) | Comma-separated skill list for priority boosting |
License
Apache-2.0