hubspot-audit

Audit a HubSpot portal across eight CRM dimensions and generate a prioritized Markdown report.

58|16|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/TomGranot/hubspot-admin-skills --skill hubspot-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hubspot-audit
Source: https://github.com/TomGranot/hubspot-admin-skills/tree/main/skills/hubspot-audit
Command: npx skills add https://github.com/TomGranot/hubspot-admin-skills --skill hubspot-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires hubspot-api-client, python-dotenv, and includes scripts (resource) components.

What problem does it solve?

Auditing a HubSpot portal can be time-consuming and error-prone when trying to assess data quality, engagement, ownership, and process health across eight critical dimensions. This skill automates the end-to-end audit, provides a clear benchmark, and surfaces prioritized remediation steps.

Core Features & Use Cases

  • Full diagnostic audit across eight dimensions: database size, deliverability, data completeness, engagement health, duplicates, owner health, lists & workflows, and deal pipeline health.
  • Generates a prioritized report with actionable recommendations suitable for onboarding new clients, quarterly health checks, and cleanup projects.
  • Produces an exportable Markdown report and supports integration with a phased cleanup plan.

Quick Start

Run the audit_portal.py script to generate the HubSpot CRM audit report for your portal.

Frequently Asked Questions about hubspot-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a comprehensive HubSpot CRM audit for data quality and portal health?

Run a comprehensive HubSpot CRM audit by executing the audit_portal.py script, which connects to your portal via the HubSpot API client to collect metrics across eight dimensions and outputs a prioritized Markdown report with actionable recommendations.

What is included in a HubSpot portal health check across contacts, companies, and deals?

A HubSpot portal health check evaluates eight dimensions: database size, deliverability, data completeness, engagement health, duplicates, owner health, lists and workflows, and deal pipeline health, grading each area to surface prioritized remediation steps.

Can I use this CRM audit script for HubSpot onboarding and quarterly health checks?

Yes, you can use this CRM audit script for HubSpot onboarding, quarterly health checks, and cleanup projects, applying the diagnostic process across contacts, companies, deals, and data quality to benchmark portal health.

Do I need a HubSpot API client and python-dotenv to automate portal reporting and metrics collection?

Yes, you need the hubspot-api-client and python-dotenv dependencies installed in your Python environment to authenticate and automate the collection of CRM metrics for the diagnostic reporting workflow.

What is the best way to diagnose gaps and data completeness issues in a HubSpot portal?

The best way to diagnose gaps in a HubSpot portal is to run an automated audit that collects metrics across eight critical dimensions, grades data completeness and engagement health, and generates an exportable Markdown report with prioritized cleanup steps.

How does the HubSpot audit script handle deal pipeline health and duplicate detection?

The HubSpot audit script evaluates deal pipeline health and duplicate detection by collecting relevant CRM metrics via the API, grading the results, and outputting actionable recommendations directly within the generated Markdown report.