convez.ai
SkillIntegração & APIsIntermediário
andrewm621

HubSpot Context Pack

andrewm621/hubspot-context-pack

Injeção contextual de 17 skills HubSpot para desenvolvimento integrado

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin 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-pack

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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:

  1. 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.

  2. 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.

  3. Bash Commands — When you run HubSpot CLI commands or API calls, matching skills are injected.

  4. 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)

SkillDomainKey Topics
hubspot-authAuthenticationPrivate Apps, OAuth 2.0, scopes, token refresh
contactsCRM ContactsCRUD, search, properties, lists, associations

Tier 1 — Core (Priority 7)

SkillDomainKey Topics
companiesCRM CompaniesCRUD, search, domains, associations
dealsCRM DealsCRUD, pipelines, stages, associations
custom-objectsCustom ObjectsSchema definition, properties, associations

Tier 2 — Extended (Priority 5-6)

SkillDomainKey Topics
workflowsAutomationTriggers, actions, branching, custom code
webhooksWebhooksSubscriptions, verification, retry policy
associationsAssociationsTypes, labels, batch operations, schemas
propertiesPropertiesCustom properties, groups, options, calculated
ticketsService HubPipelines, SLAs, support ticket management
email-marketingEmailTransactional, marketing, subscriptions
formsFormsSubmission API, fields, progressive profiling
listsListsStatic vs active, membership, segmentation

Tier 3 — Specialized (Priority 4)

SkillDomainKey Topics
cmsCMS HubPages, blog, HubDB, templates, HubL
reportingAnalyticsReports, attribution, traffic analytics
conversationsConversationsInbox, threads, chat, custom channels
crm-extensionsUI ExtensionsCRM cards, timeline events, calling

Skill Format

Each skill follows a 6-section structure:

  1. What It Is & When to Use It — 2-3 sentence orientation
  2. Service Surface — Endpoints, rate limits, required scopes (table format)
  3. Mental Model — 3-5 conceptual primitives
  4. Common Patterns — Recipes with TypeScript code using @hubspot/api-client
  5. Gotchas — Real rate limit traps, quirks, deprecated behaviors, common mistakes
  6. 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 VariableDefaultDescription
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

Ver o original no GitHub

Bom para

Relacionados