lifecycle-progression-workflow
À propos
Cette compétence automatise la progression des contacts dans l'entonnoir de vente en créant des workflows qui déclenchent des transitions d'étape en fonction d'événements spécifiques. Elle fait passer les contacts de Prospect à MQL (seuil de score atteint), de MQL à SQL (réunion planifiée), de SQL à Opportunité (affaire créée), et d'Opportunité à Client (affaire remportée). Utilisez-la pour mettre en œuvre une automatisation complète et pilotée par les événements du cycle de vie dans HubSpot.
Installation rapide
Claude Code
Recommandénpx skills add TomGranot/hubspot-admin-skills -a claude-code/plugin add https://github.com/TomGranot/hubspot-admin-skillsgit clone https://github.com/TomGranot/hubspot-admin-skills.git ~/.claude/skills/lifecycle-progression-workflowCopiez et collez cette commande dans Claude Code pour installer cette compétence
Documentation
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
| From | To | Trigger |
|---|---|---|
| Lead | MQL | Lead score exceeds threshold |
| MQL | SQL | Meeting booked |
| SQL | Opportunity | Deal created and associated |
| Opportunity | Customer | Deal marked as closed-won |
Prerequisites
- HubSpot Marketing Professional or Enterprise plan
- Lead scoring model configured (run
/build-lead-scoringfirst) - 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:
- Open the HubSpot workflow builder in Chrome (Automation > Workflows > Create workflow)
- Activate the Claude Chrome extension
- Describe each of the four progression workflows using the specifications from this skill
- 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
- Define your MQL score threshold (typically 40-60 on a 0-100 scale). Adjust after 30-60 days of observation.
- Confirm your deal pipeline stages include a clear "Closed Won" equivalent.
- 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
- Trigger: HubSpot score is greater than or equal to [threshold] AND lifecycle stage is "Lead"
- Action: Set lifecycle stage to "Marketing Qualified Lead"
- Action (optional): Send internal notification to marketing team
- Re-enrollment: OFF
Workflow 2: MQL to SQL
- 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"
- Action: Set lifecycle stage to "Sales Qualified Lead"
- Action (optional): Send internal notification to sales owner
- Re-enrollment: OFF
Workflow 3: SQL to Opportunity
- Trigger: Associated deal is created (use "Number of associated deals" is greater than 0) AND lifecycle stage is "Sales Qualified Lead"
- Action: Set lifecycle stage to "Opportunity"
- Re-enrollment: OFF
Workflow 4: Opportunity to Customer
- Trigger: Associated deal stage equals "Closed Won" AND lifecycle stage is "Opportunity"
- Action: Set lifecycle stage to "Customer"
- Action (optional): Send internal notification to CS/onboarding team
- 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
- Test each workflow with a test contact:
- Manually adjust score/create meeting/create deal/close deal and confirm progression.
- Verify that workflows do not conflict — a contact should not be enrolled in two progression workflows simultaneously.
- Check that lifecycle stages only move forward (HubSpot enforces this by default, but verify).
- 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
- Turn off any or all four workflows.
- Lifecycle stages already set remain — HubSpot does not allow backward movement without manual override or a dedicated reset workflow.
- 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.
Dépôt GitHub
Compétences associées
content-collections
MétaCette compétence propose une configuration éprouvée en production pour Content Collections, un outil axé sur TypeScript qui transforme des fichiers Markdown/MDX en collections de données typées de manière sûre avec une validation Zod. Utilisez-la lors de la création de blogs, de sites de documentation ou d'applications Vite + React riches en contenu pour garantir la sécurité de typage et la validation automatique du contenu. Elle couvre tout, de la configuration du plugin Vite et de la compilation MDX à l'optimisation des déploiements et la validation des schémas.
polymarket
MétaCette compétence permet aux développeurs de créer des applications avec la plateforme de marchés prédictifs Polymarket, incluant l'intégration d'API pour le trading et les données de marché. Elle fournit également une diffusion de données en temps réel via WebSocket pour surveiller les transactions en direct et l'activité du marché. Utilisez-la pour mettre en œuvre des stratégies de trading ou pour créer des outils traitant les mises à jour de marché en direct.
creating-opencode-plugins
MétaCette compétence aide les développeurs à créer des plugins OpenCode qui s'interconnectent avec plus de 25 types d'événements tels que les commandes, les fichiers et les opérations LSP. Elle fournit la structure du plugin, les spécifications de l'API événementielle et les modèles d'implémentation pour les modules JavaScript/TypeScript. Utilisez-la lorsque vous avez besoin d'intercepter, de surveiller ou d'étendre le cycle de vie de l'assistant IA OpenCode avec une logique personnalisée pilotée par les événements.
sglang
MétaSGLang est un framework de service LLM haute performance spécialisé dans la génération rapide et structurée pour les workflows JSON, regex et agentiques grâce à son cache de préfixe RadixAttention. Il offre une inférence nettement plus rapide, particulièrement pour les tâches avec des préfixes répétés, ce qui le rend idéal pour les sorties complexes et structurées ainsi que les conversations multi-tours. Choisissez SGLang plutôt que des alternatives comme vLLM lorsque vous avez besoin d'un décodage contraint ou que vous construisez des applications avec un partage étendu de préfixes.
