返回技能列表

build-lead-scoring

TomGranot
更新于 2 days ago
4 次查看
33
11
33
在 GitHub 上查看
design

关于

This Claude Skill builds a two-dimensional lead scoring model in HubSpot, separating Fit Score (company/persona fit) from Engagement Score (behavioral signals with time decay). It replaces the deprecated HubSpot Score property and enables prioritized outreach and marketing automation. Developers can use it to implement a modern scoring system that helps sales prioritize by fit and marketing by engagement recency.

快速安装

Claude Code

推荐
主要方式
npx skills add TomGranot/hubspot-admin-skills -a claude-code
插件命令备选方式
/plugin add https://github.com/TomGranot/hubspot-admin-skills
Git 克隆备选方式
git clone https://github.com/TomGranot/hubspot-admin-skills.git ~/.claude/skills/build-lead-scoring

在 Claude Code 中复制并粘贴此命令以安装该技能

技能文档

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.

GitHub 仓库

TomGranot/hubspot-admin-skills
路径: skills/build-lead-scoring
0

相关推荐技能

content-collections

Content Collections 是一个 TypeScript 优先的构建工具,可将本地 Markdown/MDX 文件转换为类型安全的数据集合。它专为构建博客、文档站和内容密集型 Vite+React 应用而设计,提供基于 Zod 的自动模式验证。该工具涵盖从 Vite 插件配置、MDX 编译到生产环境部署的完整工作流。

查看技能

polymarket

这个Claude Skill为开发者提供完整的Polymarket预测市场开发支持,涵盖API调用、交易执行和市场数据分析。关键特性包括实时WebSocket数据流,可监控实时交易、订单和市场动态。开发者可用它构建预测市场应用、实施交易策略并集成实时市场预测功能。

查看技能

creating-opencode-plugins

该Skill帮助开发者创建OpenCode插件,用于接入命令、文件、LSP等25+种事件。它提供了插件结构、事件API规范和JavaScript/TypeScript实现模式,适合需要拦截操作、扩展功能或自定义事件处理的场景。开发者可通过它快速构建响应式模块来增强OpenCode AI助手的能力。

查看技能

sglang

SGLang是一个专为LLM设计的高性能推理框架,特别适用于需要结构化输出的场景。它通过RadixAttention前缀缓存技术,在处理JSON、正则表达式、工具调用等具有重复前缀的复杂工作流时,能实现极速生成。如果你正在构建智能体或多轮对话系统,并追求远超vLLM的推理性能,SGLang是理想选择。

查看技能