SKILL·E5247A

hubspot-marketing-audit

TomGranot
Aktualisiert 16 days ago
7 Ansichten
75
17
75
Auf GitHub ansehen
Kommunikationaiautomationdata

Über

Diese schreibgeschützte Skill überprüft die Marketing-Gesundheit eines HubSpot-Portals, indem sie die E-Mail-Zustellbarkeit, Datenqualität und Ressourcenausbreitung in Listen und Workflows prüft. Sie ist für den Einsatz vor Bereinigungsprojekten oder Migrationen konzipiert oder wenn die Kontaktkosten steigen. Die Prüfung identifiziert inaktive Kontakte und Ineffizienzen, um Kosten zu sparen und den Absenderruf zu schützen.

Schnellinstallation

Claude Code

Empfohlen
Primär
npx skills add TomGranot/hubspot-admin-skills -a claude-code
Plugin-BefehlAlternativ
/plugin add https://github.com/TomGranot/hubspot-admin-skills
Git CloneAlternativ
git clone https://github.com/TomGranot/hubspot-admin-skills.git ~/.claude/skills/hubspot-marketing-audit

Kopieren Sie diesen Befehl und fügen Sie ihn in Claude Code ein, um diese Fähigkeit zu installieren

Dokumentation

HubSpot Marketing Audit

A read-only audit of everything marketing operations owns in a HubSpot portal. It answers three questions: can we reach the people in this database, do we know enough about them to segment, and how much of what we pay for is dead weight.

Why This Matters

Marketing pays for contacts by the tier and earns deliverability by the send. A database full of bounced, unsubscribed, and never-engaged contacts costs money on one side and sender reputation on the other, and both problems stay invisible until someone counts. This audit counts.

How It Relates to the Other Audits

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

If you ownRun
Marketing onlythis skill
Sales only/hubspot-sales-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 contacts, companies, owners, lists, forms, and automation
  • Python 3.10+ with uv

No Marketing Hub tier is required to run the audit. Rows that need a feature the portal does not have 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).

uv run ../hubspot-audit/scripts/audit_portal.py --scope marketing

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

What It Measures

DimensionMetricsGraded on
Email DeliverabilityMarketing contacts, hard bounces, global unsubscribes, 3+ bounces, never emailedhard bounces + unsubscribes
Contact Data CompletenessMissing email, lifecycle stage, company, industry, country, job titlemissing lifecycle stage
Engagement HealthOpened in 90 days, never opened, last open over a year ago, current customers at the wrong stagenever opened
List, Workflow & Form HealthTotal lists, active vs inactive workflows, formsnot graded
Shared: Owner Health, Company Data, Database Size, Duplicatessee /hubspot-audit

Reading the Results

The script produces counts and a prescription. The interpretation is the part that needs a person, or Claude with context:

  1. Start with what is billed but unreachable. Hard-bounced and globally unsubscribed contacts that are still marketing contacts are pure cost. These are P0 for a reason: the fix is safe, fast, and pays for itself.
  2. Separate "never emailed" from "never opened". Never emailed is often fine (sales-owned contacts, recent imports). Never opened after many sends is a ghost contact and a deliverability liability.
  3. Check Apple Mail Privacy Protection before trusting opens. Machine opens inflate open-based engagement. If the "opened in 90 days" share looks too healthy, use clicks as the engagement signal when deciding who to sunset.
  4. Read completeness against how you segment. A missing job title only matters if you segment or score on it. Ask which properties drive lists, scoring, and routing, and weigh those gaps first.
  5. Treat asset counts as a prompt, not a verdict. The audit reports how many lists, workflows, and forms exist. Whether 300 lists is sprawl depends on the team; the cleanup skills do the per-asset analysis.

From Findings to Fixes

The report's Prescription table maps each finding to its skill. The usual marketing order:

OrderSkillFixes
1/delete-no-email-contactsContacts that can never be emailed
2/suppress-hard-bounced, /suppress-global-unsubscribesBilled contacts you cannot or must not email
3/suppress-ghost-contactsNever-engaged contacts dragging down reputation
4/fix-lifecycle-stages, /enrich-company-name, /enrich-industry, /backfill-geo-dataGaps that block segmentation
5/create-icp-tiers, /build-lead-scoring, /build-smart-listsTargeting, once the data supports it
6/bounce-monitoring-workflow, /engagement-suppression-workflow, /new-contact-hygiene-workflowKeeping it fixed
7/cleanup-lists, /cleanup-forms, /cleanup-workflowsAsset sprawl

Run /hubspot-implementation-plan to turn the report into a phased plan with dependencies and effort estimates.

What This Audit Does Not Cover

  • Campaign and channel performance. Per-email open and click rates, attribution, and ad spend live in the marketing email statistics API and HubSpot's reports. This audit is about the database those campaigns run on.
  • Content and SEO. Pages, blogs, and CTAs are out of scope.
  • Consent and legal basis. The audit counts unsubscribes; it does not assess whether your consent model is compliant.

Rollback

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

GitHub Repository

TomGranot/hubspot-admin-skills
Pfad: skills/hubspot-marketing-audit
0
hubspothubspot-apihubspot-crmhubspot-integration
FAQ

Häufig gestellte Fragen

Was ist der Skill hubspot-marketing-audit?

hubspot-marketing-audit ist ein Claude Skill von TomGranot. Skills bündeln Anweisungen und Ressourcen, die Claude bei Bedarf lädt, um Aufgaben rund um hubspot-marketing-audit ohne zusätzliche Eingaben auszuführen.

Wie installiere ich hubspot-marketing-audit?

Verwende die Installationsbefehle auf dieser Seite: Füge hubspot-marketing-audit als Plugin zu Claude Code hinzu oder klone das Repository in dein Skills-Verzeichnis. Starte Claude danach neu, damit der Skill geladen wird.

Zu welcher Kategorie gehört hubspot-marketing-audit?

hubspot-marketing-audit gehört zur Kategorie Kommunikation.

Kann ich hubspot-marketing-audit kostenlos nutzen?

Ja. hubspot-marketing-audit ist auf AIMCP gelistet und kann kostenlos installiert werden.

Verwandte Skills

himalaya-email-manager
Kommunikation

Diese Claude Skill ermöglicht die E-Mail-Verwaltung über das Himalaya CLI-Tool mittels IMAP. Sie erlaubt Entwicklern, E-Mails von einem IMAP-Konto mit natürlichen Sprachabfragen zu suchen, zusammenzufassen und zu löschen. Nutzen Sie sie für automatisierte E-Mail-Workflows wie das Abrufen täglicher Zusammenfassungen oder das Durchführen von Stapeloperationen direkt aus Claude heraus.

Skill ansehen
imsg
Kommunikation

imsg ist ein CLI-Tool für macOS, mit dem Sie programmatisch über die Messages.app mit iMessage/SMS interagieren können. Es ermöglicht Entwicklern, Chats aufzulisten, Nachrichtenverläufe einzusehen, Konversationen in Echtzeit zu verfolgen sowie Nachrichten oder Anhänge zu versenden. Nutzen Sie diese Fähigkeit, um Messaging-Aufgaben zu automatisieren oder iMessage/SMS-Funktionalität in Ihre Entwicklungs-Workflows zu integrieren.

Skill ansehen
internationalization-i18n
Kommunikation

Dieses Claude Skill bietet umfassende Anleitung zur Implementierung von Internationalisierung (i18n) und Lokalisierung in Anwendungen. Es behandelt Kernaufgaben wie Nachrichtenextraktion, Übersetzungsmanagement, gebietsschemaspezifische Formatierung und RTL-Unterstützung unter Verwendung von Bibliotheken wie i18next und gettext. Nutzen Sie es beim Aufbau mehrsprachiger Anwendungen oder beim Hinzufügen von Lokalisierungsfunktionen für internationale Nutzer.

Skill ansehen
wacli
Kommunikation

wacli ist ein Kommandozeilen-Tool, das WhatsApp-Nachrichten, -Suche und -Synchronisierung über das WhatsApp Web-Protokoll ermöglicht. Es wird hauptsächlich innerhalb von Clawdis-Workflows für die automatisierte Abwicklung verwendet, kann aber auch direkt aufgerufen werden, um Nachrichten zu senden, Chats zu synchronisieren oder den Verlauf abzufragen. Zu den Hauptfunktionen gehören QR-basierte Authentifizierung, kontinuierliche Synchronisierung im Hintergrund und die Möglichkeit, sowohl Text als auch Dateien zu versenden.

Skill ansehen