MCP HubMCP Hub
Volver a habilidades

build-lead-scoring

TomGranot
Actualizado Yesterday
2 vistas
33
11
33
Ver en GitHub
Metadesign

Acerca de

Esta Skill de Claude construye un modelo de puntuación de leads bidimensional en HubSpot, separando la Puntuación de Adecuación (fit de empresa/persona) de la Puntuación de Compromiso (señales de comportamiento con decaimiento temporal). Reemplaza la propiedad obsoleta HubSpot Score y permite una prospección priorizada y automatización de marketing. Los desarrolladores pueden usarla para implementar un sistema de puntuación moderno que ayude a ventas a priorizar por adecuación y a marketing por la reciente interacción.

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/build-lead-scoring

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

Documentación

Build Lead Scoring Model

Create a two-score lead scoring model using HubSpot's new Lead Scoring tool: a Fit score (ICP company fit + persona match) and an Engagement score (behavioral signals with time decay). This enables sales to prioritize by company fit and marketing to prioritize by engagement recency.

Why This Matters

Without scoring, every lead looks equally (un)important. Sales has no ranked list of who to call first, marketing cannot trigger stage progressions based on engagement, and there is no way to differentiate between a senior decision-maker at a target-vertical enterprise and a generic contact who has never opened an email.

Prerequisites

  • Super Admin permissions in HubSpot
  • HubSpot Marketing Hub Professional or Enterprise
  • ICP Tier property created and workflows processed (create-icp-tiers skill must be completed first)
  • Access to Marketing > Lead Scoring (the new tool, NOT the deprecated "HubSpot Score" property)

Critical: Old vs New Lead Scoring

The old "HubSpot Score" property is deprecated. Score properties stopped being editable as of July 2025 and stopped updating as of August 2025. Do NOT reference the old HubSpot Score property in any workflows, lists, or reports.

The new Lead Scoring tool (Marketing > Lead Scoring) supports:

  • Score groups with max point limits
  • Engagement decay (points reduce over time automatically)
  • Separate Fit vs Engagement score types
  • Up to 5 total scores per portal

Interview: Gather Requirements

Before executing, collect the following information from the user:

Q1: What job titles/personas are most valuable to you?

  • Examples: CEO, COO, CFO, CTO, CRO, VP of Operations, VP of Marketing, Director of Operations, Director of Marketing, Head of Procurement, Engineering Manager
  • Default: C-suite and VP-level leaders get the highest scores, followed by Director and Manager-level roles

Q2: What engagement actions matter most?

  • Examples: Email opens, email clicks, form submissions, website visits, content downloads, webinar registrations
  • Default: Form submissions (+30), email clicks (+25), website visits (+20), email opens (+15)

Q3: What negative signals should reduce scores?

  • Examples: Unsubscribe, hard bounce, competitor domain, no activity in 6+ months, free email domain (gmail, yahoo)
  • Default: Global unsubscribe (-100), hard bounce (-50), no activity 6+ months (-20), missing company name (-10)

Q4: What score threshold should trigger MQL status?

  • Examples: Fit > 30 AND Engagement > 20, combined score > 50, any threshold that matches your sales handoff criteria
  • Default: Fit Score > 30 AND Engagement Score > 20

Plan

  1. Review any existing scoring models in the portal
  2. Create the Fit Score (company fit + persona match)
  3. Create or update the Engagement Score (behavioral signals with decay)
  4. Allow 4-6 hours for HubSpot to recalculate all contacts
  5. Verify scoring distribution and accuracy (after state)

Before State

  1. Navigate to Marketing > Lead Scoring
  2. Note any existing scores (you have a limit of 5 total)
  3. Review existing score criteria — decide whether to update or replace
  4. Check that ICP Tier property is fully populated on companies (run create-icp-tiers after state check)

Execute

Create the Fit Score

  1. Go to Marketing > Lead Scoring
  2. Click Create score
  3. Select Fit as the score type
  4. Select Contact as the scored object
  5. Name it descriptively (e.g., "Lead Fit Score")

Score Group 1: ICP Company Tier

Use Associated company property > ICP Tier:

These are starting points -- calibrate based on your actual conversion data after 30 days.

CriteriaConditionPoints (suggested range)
Primary ICP CompanyICP Tier is "Tier 1 - Primary ICP"+25 to +35
Secondary ICP CompanyICP Tier is "Tier 2 - Secondary ICP"+15 to +25
Tertiary ICP CompanyICP Tier is "Tier 3 - Tertiary ICP"+5 to +15
Not ICP CompanyICP Tier is "Not ICP"-10 to -20

Score Group 2: Persona / Job Title

Use Contact property > Job title > contains any of:

These are starting points -- adjust titles and weights to match your buyer personas.

CriteriaExample Title ValuesPoints (suggested range)
C-Suite ExecutivesCEO, COO, CFO, CTO, CRO, CMO, Chief Revenue Officer+20 to +30
VP-Level LeadersVP of Operations, VP of Marketing, VP of Sales, VP of Finance+20 to +30
Director-LevelDirector of Operations, Director of Marketing, Head of Procurement, Director of Finance+15 to +25
Manager-LevelEngineering Manager, Operations Manager, Marketing Manager, Procurement Manager+10 to +20
Other Relevant TitlesAnalyst, Coordinator, Specialist (if relevant to your sales process)+5 to +10

Customize these titles based on your buyer personas. The point values should reflect how likely each persona is to be a decision-maker or champion for your product. The ranges above are starting points -- review after 30 days and adjust based on which titles actually convert.

Score Group 3: Negative Fit Signals

CriteriaConditionPoints
Missing Company NameCompany name is unknown-10
Hard BouncedHard bounce reason is known-50
Globally UnsubscribedUnsubscribed from all email = True-100
  1. Set the overall score maximum (recommended: 100)
  2. Save and turn ON

Create the Engagement Score

  1. Click Create score (or edit existing engagement score)
  2. Select Engagement as the score type
  3. Select Contact as the scored object
  4. Name it descriptively (e.g., "Lead Engagement Score")

Positive Engagement Criteria

CriteriaConditionPointsDecay
Opened Marketing EmailLast marketing email open date within last 30 days+15Monthly
Clicked Marketing EmailLast marketing email click date within last 30 days+25Monthly
Visited WebsiteNumber of Sessions > 0+20Quarterly
Submitted a FormNumber of Form Submissions > 0+30Quarterly

Negative Engagement Criteria

CriteriaConditionPoints
No Email Activity 6+ MonthsLast marketing email open date > 180 days ago-20
  1. Set the overall score maximum (recommended: 100)
  2. Save and turn ON

Example Combined Scoring Framework

For reference, here is how the two scores work together to prioritize contacts:

Contact ProfileFit ScoreEngagement ScorePriority
CEO at Tier 1 company, clicked email this week~60~55Highest
Director of Operations at Tier 2 company, form submission~40~50High
Unknown title at Tier 3 company, email open only~10~15Medium
No title, Not ICP, no activity in 6 months~-25~-20Lowest

For Lifecycle Progression

If you want to automatically progress contacts through lifecycle stages based on scoring:

  • Define a combined threshold (e.g., Fit Score > 30 AND Engagement Score > 20 = MQL; typically the combined threshold falls in the 40-60 range, but calibrate based on your pipeline)
  • Build this as a separate workflow (not part of the scoring model itself)
  • This is a separate task from building the scoring model

After State

Allow 4-6 hours for HubSpot to fully recalculate all contact scores. The new Lead Scoring tool processes asynchronously, and large databases take time.

Verification

  1. Go to Contacts > Contacts
  2. Click Edit columns and add both score properties to visible columns
  3. Sort by Fit Score descending

Check the top 20 contacts:

  • Job titles should be target personas (CEO, VP of Operations, Director of Marketing, etc.)
  • Associated companies should be Tier 1 or Tier 2
  • If a non-relevant contact appears at the top, review the scoring criteria for issues

Check the bottom contacts:

  • Sort ascending (lowest scores first)
  • Bottom contacts should be unsubscribed, bounced, or at Not ICP companies
  • If relevant contacts appear at the bottom, review negative signal weights

Check score distribution:

  • Filter Fit Score > 50: High-priority fit (should be your best prospects)
  • Filter Fit Score 20-50: Medium fit
  • Filter Fit Score 1-19: Low fit
  • Filter Fit Score <= 0: Disqualified (should be unsubscribed, bounced, or bad data)

Sanity check:

  • Pick 3 contacts at random
  • Manually calculate their expected scores based on your criteria
  • Compare to actual scores
  • Investigate any discrepancies

Key Technical Learnings

  • The old "HubSpot Score" property is frozen. It will not update. Do not reference it in workflows, lists, or reports. Use the new Lead Scoring tool scores instead.
  • Two separate scores are better than one. Fit and Engagement serve different purposes: Fit tells you WHO to talk to (company and persona match), Engagement tells you WHEN to talk to them (behavioral recency). Combining into one number obscures both signals.
  • Score decay is a major improvement. Enable it on engagement criteria so scores naturally decrease over time. Without decay, a contact who clicked one email two years ago looks the same as one who clicked yesterday.
  • Allow 4-6 hours for recalculation. Do not panic if scores show 0 immediately after creation. The new tool processes asynchronously across the entire database.
  • Limit of 5 scores per portal. Plan carefully. You may want to reserve slots for future scores (e.g., product-specific engagement scores).
  • Tune the model after 30 days. Review whether top-scored contacts are actually converting. Adjust point values based on real conversion data. Lead scoring is iterative, not one-and-done.
  • Negative signals are as important as positive ones. Hard bounces and global unsubscribes should carry heavy negative weight to push these contacts to the bottom regardless of other factors.
  • ICP Tier is the highest-leverage scoring input. It captures firmographic fit in a single property. Without it, the Fit score has no company-level signal and relies entirely on persona matching.

Repositorio GitHub

TomGranot/hubspot-admin-skills
Ruta: skills/build-lead-scoring
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