К основному содержанию
скилл CX Codex

hubspot-sales-audit — скилл для Claude Code

Скилл hubspot-sales-audit проверяет продажную часть портала HubSpot: настройку пайплайнов, качество данных по сделкам, зависшие и просроченные сделки. Только чтение, без изменений в CRM.

MIT ★ 81 обновлён 2026-10-13

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add TomGranot/hubspot-admin-skills --skill hubspot-sales-audit -a claude-code
Открыть на GitHub

Что делает hubspot-sales-audit

Скилл считает, сколько открытых сделок без суммы, даты закрытия или владельца, сколько просрочено по дате закрытия и сколько не трогали 60 дней. Отдельно смотрит на сделки, брошенные деактивированными пользователями, на SQL- и Opportunity-контакты без владельца и на задачи, которые просрочены. Результат — отчёт reports/hubspot-sales-audit-{YYYY-MM-DD}.md и его .json-копия.

Движок лежит в соседнем скилле hubspot-audit, его нужно установить рядом — без него аудит не запустится. Нужен токен HUBSPOT_ACCESS_TOKEN в .env с правами на чтение сделок, контактов, компаний и владельцев, а для раздела по задачам и лидам — ещё и на tasks и leads. Запускается через uv на Python 3.10+.

Пороги вроде 60 дней для зависших сделок и 90 дней для окна win rate — константы в скрипте, их можно поменять под свой цикл продаж. Объект leads считается только при Sales Hub, иначе эти строки просто пустые.

Какие задачи решает

  • найти открытые сделки без суммы или даты закрытия
  • выявить просроченные по дате закрытия сделки
  • обнаружить сделки, брошенные уволенными менеджерами
  • проверить, у каких SQL-контактов нет владельца
  • посчитать просроченные задачи и неотработанные лиды

Примеры запросов агенту

  • Запусти аудит продаж в HubSpot по скоупу sales
  • Проверь, сколько открытых сделок без даты закрытия и владельца
  • Найди сделки, которые висят на деактивированных пользователях

Как установить hubspot-sales-audit

1Через Skills CLI (Vercel)

npx skills add TomGranot/hubspot-admin-skills --skill hubspot-sales-audit -a claude-code

2Вручную: положить файлы

~/.claude/skills/hubspot-sales-audit/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/hubspot-sales-audit/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о hubspot-sales-audit

Как установить hubspot-sales-audit в Claude Code?

Выполни npx skills add TomGranot/hubspot-admin-skills --skill hubspot-sales-audit -a claude-code, после чего скилл появится в ~/.claude/skills/hubspot-sales-audit/SKILL.md.

Что делает hubspot-sales-audit?

Скилл только читает данные портала HubSpot и считает проблемы в сделках: пустые суммы и даты закрытия, просрочку, зависшие сделки, сделки без владельца и несогласованные лиды.

Что нужно для работы hubspot-sales-audit?

Рядом должен быть установлен скилл hubspot-audit — он даёт движок аудита. Также нужны токен HUBSPOT_ACCESS_TOKEN с нужными правами и Python 3.10+ с uv.

Исходный текст

SKILL.md · MIT
---
name: hubspot-sales-audit
description: "Audit the sales side of a HubSpot portal: pipeline configuration, deal data quality, stale and past-due deals, ownership and handoff gaps, and overdue follow-up. Read-only. Use when the forecast is not trusted, before a pipeline redesign or a new sales leader's first review, or when reps and reports disagree about what is in the pipeline."
license: MIT
metadata:
  author: tomgranot
  version: "1.0"
  category: audit-planning
---

# HubSpot Sales Audit

A read-only audit of everything sales operations owns in a HubSpot portal. It answers one question from several angles: can anyone trust what the pipeline says?

## Why This Matters

A forecast is a sum over deal records. If a fifth of open deals have no amount, a quarter have close dates in the past, and some belong to reps who left months ago, the forecast is wrong before anyone applies judgment to it. Pipeline reviews then turn into data-entry sessions, and leaders stop using the CRM to make decisions. Most of this is measurable in a few minutes, and most of it is fixable.

## How It Relates to the Other Audits

This skill is a lens on the same engine that powers `/hubspot-audit` and `/hubspot-marketing-audit`. It runs the **shared** dimensions (database size, owner health, company data, duplicates) plus the **sales** dimensions, and skips deliverability and engagement entirely. Because the shared dimensions are computed by the same code under every scope, the numbers here match what the marketing team sees in their audit.

| If you own | Run |
|------------|-----|
| Sales only | this skill |
| Marketing only | `/hubspot-marketing-audit` |
| The whole portal | `/hubspot-audit` (both lenses in one report) |

## Prerequisites

- The `hubspot-audit` skill installed alongside this one (it ships the engine)
- `HUBSPOT_ACCESS_TOKEN` in `.env`, with read scopes for deals, contacts, companies, and owners. Add read scopes for tasks and leads to fill in the Activity & Follow-up dimension
- Python 3.10+ with [`uv`](https://github.com/astral-sh/uv)

The audit runs on any HubSpot tier with deals. The leads object needs Sales Hub; without it those rows show `n/a`.

## Run It

The engine lives in the `hubspot-audit` skill, one directory over from this one. Run it from your project directory so `.env` and `reports/` resolve there (in a clone of the repo the path is `skills/hubspot-audit/scripts/audit_portal.py`).

```bash
uv run ../hubspot-audit/scripts/audit_portal.py --scope sales
```

Output: `reports/hubspot-sales-audit-{YYYY-MM-DD}.md` and a `.json` twin.

## What It Measures

| Dimension | Metrics | Graded on |
|-----------|---------|-----------|
| Pipeline Configuration | Number of pipelines, deals (and open deals) per pipeline, pipelines with zero deals, pipelines with more than 10 open stages | empty + bloated pipelines |
| Deal Data Quality | Open deals missing amount, close date, owner, or any associated contact; closed-lost deals with no loss reason | missing amount + close date |
| Pipeline Hygiene & Velocity | Open deals with no logged activity in 60+ days, open deals whose close date has passed, open deals with no next activity; deals closed and win rate over the last 90 days | stale + past-due deals |
| Sales Ownership & Handoff | Open deals owned by deactivated users; SQL and Opportunity contacts with no owner; Opportunity-stage contacts with no deal | orphaned deals + unowned sales-stage contacts |
| Activity & Follow-up | Open tasks, overdue open tasks, leads, leads with no owner | overdue tasks |
| *Shared:* Owner Health, Company Data, Database Size, Duplicates | see `/hubspot-audit` | |

Thresholds are constants in the script's `# --- Configuration ---` block: `STALE_DEAL_DAYS` (60), `WIN_RATE_WINDOW_DAYS` (90), `MAX_STAGES_PER_PIPELINE` (10). Set them to match your sales cycle before reading the grades. A 60-day stale window is strict for enterprise deals and generous for transactional ones.

## Reading the Results

1. **Past-due close dates come first.** An open deal with a close date in the past is wrong by definition: it either closed, slipped, or died, and the record says none of those. This is the cheapest forecast fix available.
2. **Stale is a conversation, not a deletion.** No logged activity in 60 days can mean a dead deal or a rep who does not log. Check a sample (the MCP server is good for this, see `/connect-hubspot-mcp`) before deciding which problem you have. The fixes are different: one is pipeline cleanup, the other is activity capture.
3. **Missing amounts skew weighted pipeline more than missing deals.** A deal with no amount contributes zero to every weighted report. If early stages legitimately have no amount yet, make amount conditionally required from the stage where it should exist.
4. **Orphaned open deals are P0.** A deal owned by a deactivated user gets no follow-up and appears in nobody's forecast. Reassign before anything else.
5. **Handoff gaps show where marketing and sales disagree.** SQL or Opportunity contacts with no owner mean routing broke. Opportunity-stage contacts with no deal mean lifecycle stage is being set by hand or by a workflow that does not create deals. Share these two rows with marketing ops: the root cause usually sits on their side of the line.
6. **Loss reasons are the cheapest win/loss data you will ever get.** If most closed-lost deals have none, make the property required on the Closed Lost stage.
7. **Win rate is context.** It is reported so the other numbers can be read against it and does not affect any grade. A healthy win rate on a pipeline full of stale deals usually means the losses are never being closed out.

## From Findings to Fixes

| Order | Skill | Fixes |
|-------|-------|-------|
| 1 | `/reassign-deactivated-owners` | Open deals and contacts owned by people who have left |
| 2 | `/assign-unowned-contacts` | Sales-stage contacts nobody is working |
| 3 | `/cleanup-deals` | Missing amounts and close dates, stale and past-due deals, test deals, unused pipelines |
| 4 | `/cleanup-lead-owners` | Unowned companies, deals, and leads; non-employee users |
| 5 | `/fix-lifecycle-stages` | Opportunity-stage contacts with no deal; customers at the wrong stage |
| 6 | `/lifecycle-progression-workflow` | Handoff automation, so the gaps do not reopen |
| 7 | `/merge-duplicate-companies` | Duplicate accounts splitting deal history |

Run `/hubspot-implementation-plan` to turn the report into a phased plan.

Prevention matters more than cleanup here. Three portal settings stop most of what this audit finds, and all three are configured in the HubSpot UI: required properties per deal stage (Settings > Objects > Deals > Pipelines), pipeline rules that restrict skipping stages and backward movement, and a workflow that creates a task for the owner when an open deal has had no activity for your stale window.

## What This Audit Does Not Cover

- **Forecast accuracy and time in stage.** HubSpot's forecast tool and pipeline reports own these. Forecast submissions are readable by API on Sales Hub Professional and above (`crm.objects.forecasts.read`) if you want to extend the engine.
- **Sequences.** The Sequences API only works with user-level authentication, so an account-level token cannot audit enrollment.
- **Rep performance.** The audit measures data quality, not people. Per-owner breakdowns are a deliberate omission: add them only if the team has agreed how they will be used.
- **Quotes, products, and line items.** Out of scope for now.

## Rollback

Nothing to roll back: the audit only reads. To remove its output, delete the files it wrote under `reports/`.

© tomgranot · MIT · TomGranot/hubspot-admin-skills

Похожие скиллы

Все скиллы по теме «Маркетинг и контент» →
hubspot-sales HubSpot Плагин hubspot-sales ведёт рабочий день продавца прямо в Claude: импорт контактов и сделок, утренняя сводка, подготовка к звонку, черновики follow-up. Всё пишется обратно в HubSpot. ★ 5звёзд репо HubSpot hubspot Инструмент для прямого доступа к HubSpot CRM через чат с ассистентом. Позволяет искать контакты, смотреть пайплайны сделок и проверять тикеты без перехода в веб-интерфейс. CX Codex +1 1 166установок sales-reporting HubSpot Скилл sales-reporting собирает сводки по сделкам HubSpot прямо в терминале: что закрывается на этой неделе, пайплайн по стадиям и владельцам, win/loss за период. CX Codex +1 1 900установок hubspot-automation davepoon Скилл hubspot-automation автоматизирует работу с контактами, сделками, компаниями и тикетами HubSpot CRM через Rube MCP и Composio. CX Codex +1 126установок sales-ops-analyst ncklrs Скилл sales-ops-analyst для Claude Code задаёт агенту правила операционной работы отдела продаж: воронка, маршрутизация лидов, территории, комиссии и прогноз. Считает показатели на ваших данных. CX Codex +1 251установок sales-pipeline-hygiene Maya-Beth Finotti Скилл sales-pipeline-hygiene проверяет активный пайплайн по чек-листу: находит зависшие сделки, сдвинутые даты закрытия и пустые поля, важные для прогноза. CX Codex +1 27 600установок

Из того же набора39

Весь набор →
quarterly-database-cleanup Скилл quarterly-database-cleanup для Claude Code и Codex проверяет качество данных, активность контактов и состояние списков в HubSpot, формируя отчёт со сравнением кварталов для регулярной очистки CRM. CX Codex +1 ★ 81звёзд репо new-contact-hygiene-workflow Скилл new-contact-hygiene-workflow для Claude Code создаёт в HubSpot workflow для обогащения новых контактов при создании: задаёт lifecycle stage через v4 Automation API, а копирование полей компании добавляется в интерфейсе. CX Codex +1 ★ 81звёзд репо merge-duplicate-companies Скилл merge-duplicate-companies находит дубликаты компаний в HubSpot по доменам и названиям, готовит CSV-отчёты и помогает спланировать объединение записей. CX Codex +1 ★ 81звёзд репо lifecycle-progression-workflow Скилл lifecycle-progression-workflow для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Создаёт четыре workflow в HubSpot, которые двигают контакты по этапам от Lead до Customer по заданным событиям. CX Codex +1 ★ 81звёзд репо hubspot-marketing-audit Скилл hubspot-marketing-audit проводит read-only аудит маркетинговой базы HubSpot: находит платные неактивные контакты, ошибки доставляемости и пробелы в свойствах перед чисткой или миграцией. CX Codex +1 ★ 81звёзд репо hubspot-implementation-plan Скилл hubspot-implementation-plan превращает отчёт аудита HubSpot в план очистки портала по этапам. Помогает расставить задачи по приоритету и учесть зависимости и способы автоматизации. CX Codex +1 ★ 81звёзд репо hubspot-audit Скилл hubspot-audit проверяет портал HubSpot по базе данных, доставляемости писем, воронкам и сделкам, не меняя ни одной записи. Запускается при старте чистки CRM или перед квартальным отчётом. CX Codex +1 ★ 81звёзд репо fix-lifecycle-stages Скилл fix-lifecycle-stages находит контакты и компании без lifecycle stage в HubSpot, исправляет запрещённые стадии и выравнивает воронку через API. CX Codex +1 ★ 81звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой