← 返回 Skills 市场
tomgranot

Build Lead Scoring

作者 TomGranot · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ 安全检测通过
128
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install build-lead-scoring
功能描述
Create a comprehensive lead scoring model with separate Fit and Engagement scores using HubSpot's new Lead Scoring tool. Replaces the deprecated HubSpot Scor...
使用说明 (SKILL.md)

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.

Criteria Condition Points (suggested range)
Primary ICP Company ICP Tier is "Tier 1 - Primary ICP" +25 to +35
Secondary ICP Company ICP Tier is "Tier 2 - Secondary ICP" +15 to +25
Tertiary ICP Company ICP Tier is "Tier 3 - Tertiary ICP" +5 to +15
Not ICP Company ICP 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.

Criteria Example Title Values Points (suggested range)
C-Suite Executives CEO, COO, CFO, CTO, CRO, CMO, Chief Revenue Officer +20 to +30
VP-Level Leaders VP of Operations, VP of Marketing, VP of Sales, VP of Finance +20 to +30
Director-Level Director of Operations, Director of Marketing, Head of Procurement, Director of Finance +15 to +25
Manager-Level Engineering Manager, Operations Manager, Marketing Manager, Procurement Manager +10 to +20
Other Relevant Titles Analyst, 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

Criteria Condition Points
Missing Company Name Company name is unknown -10
Hard Bounced Hard bounce reason is known -50
Globally Unsubscribed Unsubscribed 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

Criteria Condition Points Decay
Opened Marketing Email Last marketing email open date within last 30 days +15 Monthly
Clicked Marketing Email Last marketing email click date within last 30 days +25 Monthly
Visited Website Number of Sessions > 0 +20 Quarterly
Submitted a Form Number of Form Submissions > 0 +30 Quarterly

Negative Engagement Criteria

Criteria Condition Points
No Email Activity 6+ Months Last 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 Profile Fit Score Engagement Score Priority
CEO at Tier 1 company, clicked email this week ~60 ~55 Highest
Director of Operations at Tier 2 company, form submission ~40 ~50 High
Unknown title at Tier 3 company, email open only ~10 ~15 Medium
No title, Not ICP, no activity in 6 months ~-25 ~-20 Lowest

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 \x3C= 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.
安全使用建议
This skill is an instruction-only playbook for configuring HubSpot Lead Scoring and appears coherent with that purpose. Before using it: 1) Ensure you (or the person executing these steps) have HubSpot Super Admin rights and a test/dev portal available — changing scores can affect live workflows and MQL routing. 2) Back up or document existing scoring, lists, and workflows before making changes and test thresholds on a subset of contacts. 3) Verify the ICP Tier property is correctly populated (the skill depends on it). 4) Because the skill has no code and requests no credentials, it can't run automated changes itself — a human or another integration must perform the UI/API actions; confirm who will perform them. If you want the agent to perform API-based changes automatically in future, expect additional credential requirements (HubSpot API key/OAuth) and reassess proportionality and risk at that time.
功能分析
Type: OpenClaw Skill Name: build-lead-scoring Version: 1.0.0 The skill bundle contains instructions for an AI agent to configure a lead scoring model within HubSpot. It consists of metadata and a markdown file (SKILL.md) outlining a standard business process without any executable code, data exfiltration attempts, or malicious prompt injection.
能力评估
Purpose & Capability
The skill's name and description (build a Fit and Engagement lead scoring model in HubSpot) match the instructions. Required permissions (HubSpot Super Admin, Marketing Hub Professional/Enterprise) and the need for an existing ICP Tier property are appropriate for the stated task. There are no extraneous environment variables, binaries, or config paths requested.
Instruction Scope
SKILL.md contains step-by-step human-facing instructions for using the HubSpot UI (Marketing > Lead Scoring) and for designing score groups and thresholds. The instructions do not direct the agent to read unrelated local files, environment variables, or send data to external endpoints. It references completing a prerequisite skill (create-icp-tiers) which is consistent with the workflow.
Install Mechanism
No install spec and no code files — this is instruction-only. That minimizes on-disk risk and there are no downloads, package installs, or arbitrary executables referenced.
Credentials
The skill requests no environment variables, credentials, or config paths. It appropriately notes HubSpot admin permissions as a human prerequisite; it does not ask the agent to access unrelated service credentials or secrets.
Persistence & Privilege
always is false and there is no install behavior that writes persistent configuration or modifies other skills. The skill does not request permanent presence or elevated platform privileges.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install build-lead-scoring
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /build-lead-scoring 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
- Initial release of build-lead-scoring skill. - Provides a complete guide for implementing Fit and Engagement lead scoring models using HubSpot's new Lead Scoring tool. - Includes instructions for setting up both Fit (company and persona-based) and Engagement (behavioral with time decay) scores. - Highlights key requirements, including deprecation of the old HubSpot Score and need for the ICP Tier property. - Offers best-practice scoring criteria, interview prompts, and suggestions for automating lifecycle progression based on scores.
元数据
Slug build-lead-scoring
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Build Lead Scoring 是什么?

Create a comprehensive lead scoring model with separate Fit and Engagement scores using HubSpot's new Lead Scoring tool. Replaces the deprecated HubSpot Scor... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 128 次。

如何安装 Build Lead Scoring?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install build-lead-scoring」即可一键安装,无需额外配置。

Build Lead Scoring 是免费的吗?

是的,Build Lead Scoring 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Build Lead Scoring 支持哪些平台?

Build Lead Scoring 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Build Lead Scoring?

由 TomGranot(@tomgranot)开发并维护,当前版本 v1.0.0。

💬 留言讨论