MCP HubMCP Hub
Volver a habilidades

lifecycle-progression-workflow

TomGranot
Actualizado 2 days ago
6 vistas
33
11
33
Ver en GitHub
Metaautomationdesign

Acerca de

Esta habilidad automatiza la progresión de contactos a través del embudo de ventas mediante la creación de flujos de trabajo que activan transiciones de etapa basadas en eventos específicos. Mueve los contactos de Lead a MQL (umbral de puntuación), de MQL a SQL (reunión agendada), de SQL a Oportunidad (acuerdo creado) y de Oportunidad a Cliente (acuerdo ganado). Úsela para implementar una automatización completa del ciclo de vida basada en eventos dentro de HubSpot.

Instalación rápida

Claude Code

Recomendado
Principal
npx skills add TomGranot/hubspot-admin-skills -a claude-code
Comando PluginAlternativo
/plugin add https://github.com/TomGranot/hubspot-admin-skills
Git CloneAlternativo
git clone https://github.com/TomGranot/hubspot-admin-skills.git ~/.claude/skills/lifecycle-progression-workflow

Copia y pega este comando en Claude Code para instalar esta habilidad

Documentación

Lifecycle Stage Progression Workflow

Automate the contact journey through the sales funnel with four progression workflows, each triggered by a specific business event.

Progression Paths

FromToTrigger
LeadMQLLead score exceeds threshold
MQLSQLMeeting booked
SQLOpportunityDeal created and associated
OpportunityCustomerDeal marked as closed-won

Prerequisites

  • HubSpot Marketing Professional or Enterprise plan
  • Lead scoring model configured (run /build-lead-scoring first)
  • Deal pipeline set up with a "Closed Won" stage
  • Meeting tool or integration configured (for SQL transition)

Building the Workflow: Three Options

Option 1: Manual UI Build

Follow the step-by-step instructions in the "Execute" section below. This is the most reliable method and gives you full control over every trigger, branch, and action.

Option 2: HubSpot Breeze AI

HubSpot's built-in Breeze AI can generate workflow skeletons from natural language prompts. Navigate to Automation > Workflows > Create workflow > "Describe what you want" and paste one prompt per workflow. You will need to create four separate workflows:

Workflow 1 -- Lead to MQL:

Create a contact-based workflow that triggers when a contact's HubSpot score
is greater than or equal to [your MQL threshold] AND their lifecycle stage is "Lead".
The workflow should set the lifecycle stage to "Marketing Qualified Lead"
and send an internal notification to the marketing team.

Workflow 2 -- MQL to SQL:

Create a contact-based workflow that triggers when a meeting is booked with
a contact AND their lifecycle stage is "Marketing Qualified Lead".
The workflow should set the lifecycle stage to "Sales Qualified Lead"
and send an internal notification to the sales owner.

Workflow 3 -- SQL to Opportunity:

Create a contact-based workflow that triggers when a contact has an associated
deal created AND their lifecycle stage is "Sales Qualified Lead".
The workflow should set the lifecycle stage to "Opportunity".

Workflow 4 -- Opportunity to Customer:

Create a contact-based workflow that triggers when a contact's associated deal
stage equals "Closed Won" AND their lifecycle stage is "Opportunity".
The workflow should set the lifecycle stage to "Customer"
and send an internal notification to the CS/onboarding team.

CRITICAL WARNING: Breeze trigger limitations. Breeze creates event-based triggers (OR logic) instead of filter-based triggers (AND logic). Each of these four workflows requires AND logic between the event condition and the current lifecycle stage. After Breeze creates each workflow, you MUST manually verify and fix the trigger/enrollment conditions in the UI to ensure both conditions are ANDed together. Breeze is best used for creating the workflow skeleton (actions, branches, delays) -- the trigger conditions almost always need manual correction.

Additional Breeze limitations for these workflows:

  • Breeze cannot configure re-enrollment rules
  • Breeze may not correctly set the lifecycle stage condition as part of the enrollment trigger (it may create it as a branch instead)

Option 3: Claude Anthropic Chrome Extension

The Claude Anthropic Chrome extension lets Claude see and interact with the HubSpot workflow builder UI directly. You can describe the workflow logic in natural language and Claude will click through the UI to build it. This is often more accurate than Breeze for workflows requiring precise AND-logic triggers, because Claude can verify each trigger condition visually.

To use this approach:

  1. Open the HubSpot workflow builder in Chrome (Automation > Workflows > Create workflow)
  2. Activate the Claude Chrome extension
  3. Describe each of the four progression workflows using the specifications from this skill
  4. Build them one at a time, verifying triggers before moving to the next

Note on Fast Mode: If you're using Claude Code's Fast Mode to speed up workflow creation, be aware of the billing model: Haiku usage is included in your subscription, but Opus in Fast Mode consumes extra credits. For workflow building tasks (which are UI-heavy and may require many interactions), consider whether the speed tradeoff is worth the credit cost.

Step-by-Step Build Instructions

Stage 1: Before — Plan Thresholds

  1. Define your MQL score threshold (typically 40-60 on a 0-100 scale). Adjust after 30-60 days of observation.
  2. Confirm your deal pipeline stages include a clear "Closed Won" equivalent.
  3. Document current lifecycle stage distribution (run the audit or check the property breakdown) so you can measure the impact.

Stage 2: Execute — Build Four Workflows

Build each as a separate contact-based workflow.

Workflow 1: Lead to MQL

  1. Trigger: HubSpot score is greater than or equal to [threshold] AND lifecycle stage is "Lead"
  2. Action: Set lifecycle stage to "Marketing Qualified Lead"
  3. Action (optional): Send internal notification to marketing team
  4. Re-enrollment: OFF

Workflow 2: MQL to SQL

  1. Trigger: Meeting booked (use "Meeting activity date" is known, or "Number of meetings booked" is greater than 0) AND lifecycle stage is "Marketing Qualified Lead"
  2. Action: Set lifecycle stage to "Sales Qualified Lead"
  3. Action (optional): Send internal notification to sales owner
  4. Re-enrollment: OFF

Workflow 3: SQL to Opportunity

  1. Trigger: Associated deal is created (use "Number of associated deals" is greater than 0) AND lifecycle stage is "Sales Qualified Lead"
  2. Action: Set lifecycle stage to "Opportunity"
  3. Re-enrollment: OFF

Workflow 4: Opportunity to Customer

  1. Trigger: Associated deal stage equals "Closed Won" AND lifecycle stage is "Opportunity"
  2. Action: Set lifecycle stage to "Customer"
  3. Action (optional): Send internal notification to CS/onboarding team
  4. Re-enrollment: OFF

Workflow Settings (all four)

  • Re-enrollment: OFF (lifecycle should only progress forward)
  • Suppression list: None needed — the lifecycle stage condition prevents backwards movement
  • Time zone: Not applicable

Stage 3: After — Verify

  1. Test each workflow with a test contact:
    • Manually adjust score/create meeting/create deal/close deal and confirm progression.
  2. Verify that workflows do not conflict — a contact should not be enrolled in two progression workflows simultaneously.
  3. Check that lifecycle stages only move forward (HubSpot enforces this by default, but verify).
  4. After one week, review the workflow history for each. Check for:
    • Contacts stuck at a stage despite meeting criteria
    • Unexpected enrollment volumes

Stage 4: Rollback

  1. Turn off any or all four workflows.
  2. Lifecycle stages already set remain — HubSpot does not allow backward movement without manual override or a dedicated reset workflow.
  3. If stages were set incorrectly, create a temporary workflow or use the API to reset affected contacts.

Notes

  • Backward movement: HubSpot prevents lifecycle stage from going backward by default. If a deal is lost and the contact should return to MQL, you need a separate "regression" workflow that explicitly sets the stage.
  • Multiple deals: If a contact has multiple deals, the Opportunity-to-Customer workflow fires when any associated deal is closed-won. This is usually the desired behavior.
  • Score decay: If your lead scoring model includes decay, a contact's score may drop below the MQL threshold after promotion. This is fine — the lifecycle stage is already set and will not regress.

Repositorio GitHub

TomGranot/hubspot-admin-skills
Ruta: skills/lifecycle-progression-workflow
0

Habilidades relacionadas

content-collections

Meta

Esta habilidad proporciona una configuración probada en producción para Content Collections, una herramienta centrada en TypeScript que transforma archivos Markdown/MDX en colecciones de datos con tipado seguro mediante validación Zod. Úsala al construir blogs, sitios de documentación o aplicaciones Vite + React con mucho contenido para garantizar seguridad de tipos y validación automática de contenido. Abarca todo, desde la configuración del plugin de Vite y compilación MDX hasta la optimización de despliegue y validación de esquemas.

Ver habilidad

polymarket

Meta

Esta habilidad permite a los desarrolladores crear aplicaciones con la plataforma de mercados de predicción Polymarket, incluyendo la integración de API para operaciones y datos de mercado. También proporciona transmisión de datos en tiempo real a través de WebSocket para monitorear operaciones en vivo y actividad del mercado. Úsela para implementar estrategias de trading o crear herramientas que procesen actualizaciones de mercado en tiempo real.

Ver habilidad

creating-opencode-plugins

Meta

Esta habilidad ayuda a los desarrolladores a crear complementos de OpenCode que se conectan a más de 25 tipos de eventos, como comandos, archivos y operaciones LSP. Proporciona la estructura del complemento, las especificaciones de la API de eventos y los patrones de implementación para módulos en JavaScript/TypeScript. Úsala cuando necesites interceptar, monitorear o extender el ciclo de vida del asistente de IA de OpenCode con lógica personalizada basada en eventos.

Ver habilidad

sglang

Meta

SGLang es un framework de alto rendimiento para el servicio de LLM que se especializa en generación rápida y estructurada para JSON, expresiones regulares y flujos de trabajo de agentes utilizando su caché de prefijos RadixAttention. Ofrece una inferencia significativamente más rápida, especialmente para tareas con prefijos repetidos, lo que lo hace ideal para salidas complejas y estructuradas, y conversaciones multiturno. Elige SGLang sobre alternativas como vLLM cuando necesites decodificación restringida o estés construyendo aplicaciones con uso extensivo de prefijos compartidos.

Ver habilidad