customer-retention-hubspot-agent-cli-skills

1. 基本信息

项目	内容	数据来源
名称	customer-retention-hubspot-agent-cli-skills	—
项目自述名称	HubSpot Agent CLI Skills（合集仓库自身名）	GitHub README
作者/维护者	HubSpot（CRM/营销 SaaS 厂商），官方组织仓库	GitHub API
来源链接	https://github.com/HubSpot/agent-cli-skills/tree/main/customer-retention	—
许可证	Apache License 2.0	GitHub API
GitHub Stars / Forks	18 / 7（合集仓库整体口径，含 15 个子技能，不代表本技能个体热度；本技能自身在 skills.sh 上有约 837 次独立安装记录，见第 6 章）	GitHub API；skills.sh
最新版本	无正式版本标签，持续滚动提交	GitHub API
安装方式	`npx skills hubspot/agent-cli-skills/customer-retention`（单装）或 `npx skills hubspot/agent-cli-skills`（全装 15 个技能）	官方 README

2. 功能介绍与亮点

customer-retention 教编程 Agent 用官方 hubspot CLI 从 CRM 筛选条件中识别流失风险客户，并批量创建跟进任务，核心亮点：

两层信号覆盖：既能按联系人维度筛选“多久未联系”（notes_last_contacted）、“多久无销售活动”（hs_last_sales_activity_date）、“从未联系过”三种沉寂客户信号，也能按订阅对象维度筛选 hs_subscription_status 为逾期/取消的账号，两者可分别独立使用，也可关联查询（订阅 → 所属联系人）统一触达
枚举值先核实再用：hs_subscription_status 等字段的允许取值因 HubSpot 门户而异，文档明确要求先用 hubspot properties get 查出当前门户的实际枚举值，再代入过滤表达式，避免凭经验硬编码导致查询静默返回空结果
完整的批量跟进任务生成管道：从筛出沉寂客户群体、逐条构造任务负载、--dry-run 预览、执行创建，到最后按顺序保证把新建任务关联回对应联系人，四步管道一次给全，并提醒未关联的任务在 CRM 界面里不可见——这是容易被忽略的一步
诚实列出平台局限：Known gaps 一节直接说明 HubSpot 没有原生的流失分数/健康分属性（需自建自定义属性）、也没有 Lists API 或再触达序列 API 可用，把工具边界讲清楚而非留给使用者自行踩坑

亮点：官方一线 CRM 厂商出品；覆盖“识别风险→批量跟进”完整闭环而不止于查询；建立在同仓库 bulk-operations 的 JSONL 管道与 dry-run/digest 安全模式之上，批量写操作有预览确认环节。

3. 适用场景

所属分类：集成与工作流自动化（该技能的核心是从第三方 CRM 服务读取健康信号并写回跟进任务，属于对外部业务系统的操作型集成；用 --neighbors 核对“客户流失 CRM筛选跟进任务”关键词，命中的同仓库姊妹技能 sales-execution 同样落在本分类，判定一致）

客户成功或销售团队需要定期排查沉寂客户与逾期订阅、批量生成跟进任务以降低流失率的场景；也适合在续约周期前做账号健康度扫描的团队。

4. 跨 Agent 兼容性

Claude Code：✅ 原生支持——README 明确列出，默认安装到项目 .claude/skills/ 目录
Codex：❓ 未验证——已抓取材料未点名提及
OpenClaw：❓ 未验证——已抓取材料未点名提及
Hermes Agent：❓ 未验证——已抓取材料未点名提及

（README 另提及 Cursor、Windsurf 等其他编程 Agent 兼容，但不在本报告评估范围内）

5. 推荐理由

客户流失预警是一项需要持续、规律执行的运营动作，但手动在 CRM 里逐条排查“谁最近没联系”“哪些订阅逾期”、再逐个建跟进任务，是客户成功团队的高频重复劳动。这个技能把两类流失信号（联系人沉寂 + 订阅逾期）的筛选表达式、门户特定枚举值先核实再用的纪律、以及从筛选到批量建任务并正确关联的完整管道一次性写清楚，还诚实标注了 HubSpot 平台本身不具备的能力边界，让 Agent 能一次性跑通“识别风险客户→批量跟进”这条闭环，而不是只停在查询这一步。

6. 评分

维度	分数	说明
受欢迎程度	7	官方 HubSpot 仓库出品；skills.sh 平台统计该技能独立安装量约 837 次，落在同仓库 15 个子技能的主聚集区间内；第三方博客 aibuilderclub.com（2026-06-11，作者 Shirley）在其 Claude Code 销售技能栈评测中逐条点名本技能
可用性	8	单文件 SKILL.md 完整覆盖沉寂客户筛选、订阅风险标记、单条任务创建、批量任务创建四类操作，均配可直接运行的命令示例；依赖同仓库 `bulk-operations` 的分页与批处理机制作为前置阅读；仓库近期仍有提交，维护活跃
安全性	9	见下方检查清单

安全检查清单：

① Shell 命令及权限范围——通过官方 hubspot CLI 执行，读操作（objects search、properties get）与写操作（objects create 建任务、associations create 关联）范围明确，写操作均为新增而非破坏性删改 ② 联网外发——仅连接用户自己 HubSpot 账号的官方 API，目标透明 ③ 凭据——设置环境变量 HUBSPOT_ACCESS_TOKEN 或走浏览器 OAuth 登录，为标准做法，凭据不写入仓库；文档明确说明缺少 subscriptions-read 权限时的报错表现 ④ 可疑指令——SKILL.md 内容清晰、逻辑单一，未见隐藏指令或混淆代码 ⑤ 作者信誉——HubSpot 官方组织仓库，该 CLI 为其官方公开 Beta 产品 ⑥ License——Apache License 2.0，清晰 ⑦ 维护时间——仓库最近仍有提交，非弃置项目额外说明：批量建任务前有 --dry-run 预览步骤，继承自 bulk-operations 的安全模式，降低误操作规模化的风险。

7. 跟同类 Skills 相比的优势

方案	定位	差异化说明
HubSpot 官方远程 MCP Server（mcp.hubspot.com）	面向对话式 AI 助手的托管接入点，支持自然语言查询单条 CRM 对象	定位是“对话里问一条”；customer-retention 面向脚本化批量场景，内建“筛选沉寂客户/逾期订阅→批量建跟进任务”的完整管道，一次处理整个客户群体而非单条记录
TomGranot/hubspot-admin-skills（第三方社区项目，37 个技能，MIT 协议）	覆盖更广的 HubSpot 数据治理套件，含多类管理员级操作模块，基于 Python 脚本 + REST API	customer-retention 由 HubSpot 官方发布、直接建立在官方 `hubspot` CLI 之上，命令行为一等公民，无需额外 Python 运行环境；聚焦“流失风险识别与批量跟进”单一场景，而非覆盖治理全流程的大而全套件

8. 用户评价

第三方博客 aibuilderclub.com 于 2026 年 6 月 11 日发布的文章《Claude Code Sales Skills: The Complete Agent Stack》（作者 Shirley）将本技能列入其“CRM 操作”阶段的推荐技能栈，原文描述为“Identify inactive customers, flag at-risk subscriptions, create follow-up tasks”，与本技能实际能力吻合。GitHub Issue #5（用户 WesleyBLDC）反馈整个仓库 15 个子技能（含本技能）的命名过于通用，在已安装 50+ 技能的工作区中难以分辨归属，该用户已在自己的 fork 中为全部技能加前缀重命名并提交上游 PR，供维护者参考采纳。

9. 其他补充

同一仓库下另有 14 个姊妹技能（如 bulk-operations、sales-execution、crm-lookup、data-enrichment 等），均依赖 bulk-operations 的分页与批量安全模式；本技能的活动创建细节部分委托给 sales-execution 技能补充。

10. 安装使用方式

# 只安装 customer-retention 一个技能
npx skills hubspot/agent-cli-skills/customer-retention

# 安装全部 15 个技能
npx skills hubspot/agent-cli-skills

安装后需配置 HubSpot 账号访问：设置环境变量 HUBSPOT_ACCESS_TOKEN（私有应用令牌，需 subscriptions-read 等相应读写权限）或走浏览器 OAuth 登录。建议先安装并阅读 bulk-operations 技能了解 JSONL 管道与批处理约定。安装后无需重启，在对话中提及 “customer retention”、“churn risk”、“inactive customers”、“at-risk accounts” 等触发词即可调用。

11. 注意事项

依赖官方 hubspot Agent CLI（与开发 HubSpot 应用的 hs/@hubspot/cli 是两个不同工具），需单独安装
HubSpot 本身不提供原生流失分数/健康分属性，需使用者自建自定义属性；也没有 Lists API 或再触达序列 API，批量跟进后的自动化触达序列需另接其他工具
订阅相关查询需要 subscriptions-read 范围的私有应用令牌，权限不足会返回 403
CLI 目前处于官方公开 Beta 阶段，接口可能变动