HVAC Marketing Skills for AI Agents

HVAC-adapted marketing skills for AI coding agents, forked from coreyhaines31/marketingskills (MIT license). Every skill has been adapted for the HVAC industry with deep integration into the Compendium content intelligence platform.

38 skills covering HVAC content creation, local SEO, contractor marketing, seasonal campaigns, and trade-specific content strategy. Works with Claude Code, OpenAI Codex, Cursor, Windsurf, and any agent that supports the Agent Skills spec.

Upstream Credit

Original marketing skills by Corey Haines — MIT licensed. This derivative adds HVAC industry context, Compendium database integration, and 10 new HVAC-specific skills.

What's Different from Upstream

• HVAC industry focus: All SaaS examples replaced with HVAC equivalents (contractors, equipment, seasonal campaigns)
• Compendium integration: Skills can query 43K videos, 272K web articles, 15K podcasts, 6.5K social posts, and 1,400 industry statistics
• 10 new HVAC skills: Content from data, seasonal campaigns, review management, video repurposing, technical content, brand voice, contractor website audit/package, compliance claims, content QC
• 4 SaaS-only skills removed: churn-prevention, paywall-upgrade-cro, onboarding-cro, signup-flow-cro
• 2 skills reworked: popup-cro → hvac-estimate-popups, revops → hvac-lead-ops
• Shared integration contract: COMPENDIUM_INTEGRATION.md — single source of truth for all platform access

How Skills Work Together

The hvac-marketing-context skill is the foundation — every other skill checks it first to understand your brands, audience, and HVAC positioning.

                         ┌──────────────────────────────────┐
                         │      hvac-marketing-context      │
                         │  (read by all other skills first) │
                         └───────────────┬──────────────────┘
                                         │
    ┌──────────┬──────────┬──────────────┼──────────┬──────────┬──────────┐
    ▼          ▼          ▼              ▼          ▼          ▼          ▼
 SEO &      CRO      Content &     Paid &     HVAC       Sales &    Strategy
 Local               Copy         Measure    Specific    GTM

See each skill's Related Skills section for the full dependency map.

Compendium Integration

Skills operate in three modes (declared in YAML frontmatter):

Mode	Meaning
standalone	Works without any Compendium access
enhanced	Better with Compendium but fully functional without
required	Needs Compendium (only 2 skills)

See COMPENDIUM_INTEGRATION.md for full details on database queries, API endpoints, fallback behavior, and data quality rules.

Primary Brands

• HVAC Know It All (Gary McCreadie) — YouTube, Instagram, Facebook
• measureQuick (Jim Bergmann) — App, YouTube, LinkedIn

Available Skills (38)

HVAC-Specific (New)

Skill	Description
hvac-content-from-data	Create content directly from Compendium database intelligence
hvac-seasonal-campaign	Seasonal marketing tied to HVAC demand cycles
hvac-review-management	Google Business Profile review strategy
hvac-video-repurpose	Repurpose long-form video/podcast content for social
hvac-technical-content	Write technical HVAC content at the right level
hvac-brand-voice	Brand voice and personality guide for HVAC brands
hvac-contractor-website-audit	Contractor website discovery and analysis
hvac-contractor-website-package	Marketing package assembly from audit data
hvac-compliance-claims	EPA/rebate/safety claim checking
hvac-content-qc	Content quality control and citation verification

Foundation

Skill	Description
hvac-marketing-context	Foundation doc — brand profiles, audience segments, HVAC calendar

SEO & Local

Skill	Description
seo-audit	Technical, on-page, and local SEO audit
ai-seo	AI search optimization for HVAC queries
schema-markup	LocalBusiness, HVACBusiness, Service structured data
site-architecture	HVAC contractor/brand site structure
programmatic-seo	Location x service matrix page generation
competitor-alternatives	HVAC brand and tool comparisons

Content & Copy

Skill	Description
content-strategy	HVAC content pillars and gap analysis
copywriting	HVAC voice guide with real quote sourcing
copy-editing	Edit and polish existing copy
social-content	Platform-specific HVAC social content
email-sequence	HVAC newsletter and maintenance sequences
cold-email	B2B outreach for distributors and manufacturers

CRO & Conversion

Skill	Description
page-cro	HVAC service page optimization
form-cro	Quote request and scheduling forms
hvac-estimate-popups	Estimate request popups and seasonal CTAs

Paid & Measurement

Skill	Description
paid-ads	Local Service Ads and seasonal campaigns
ad-creative	HVAC ad creative with seasonal messaging
analytics-tracking	HVAC conversion tracking
ab-test-setup	A/B testing for HVAC pages

Strategy & Growth

Skill	Description
marketing-ideas	HVAC marketing tactics and campaigns
marketing-psychology	Psychology applied to HVAC marketing
pricing-strategy	HVAC service pricing strategy
referral-program	Contractor referral programs
free-tool-strategy	HVAC calculators and estimators
launch-strategy	HVAC service and product launches

Sales & Operations

Skill	Description
hvac-lead-ops	Intake-to-booked-job funnel management
sales-enablement	Equipment proposals and maintenance pitches

Installation

Clone and Copy (Recommended)

git clone http://192.168.10.31:3005/ben/hvac-marketing-skills.git
cp -r hvac-marketing-skills/skills/* .agents/skills/

Git Submodule

git submodule add http://192.168.10.31:3005/ben/hvac-marketing-skills.git .agents/hvac-marketing-skills

Usage

"Create a blog post about trending HVAC topics"
→ Uses hvac-content-from-data skill + Compendium DB

"Write an Instagram post about a field diagnostic story"
→ Uses social-content skill + hvac-brand-voice

"Audit this contractor's website: example-hvac.com"
→ Uses hvac-contractor-website-audit skill

"Check this article for compliance issues"
→ Uses hvac-compliance-claims + hvac-content-qc skills

Tools

Compendium Integration Tools

• tools/compendium/compendium-search.sh — Search Router queries
• tools/compendium/compendium-scrape.sh — Scrape Router requests
• tools/compendium/compendium-classify.sh — Classification API calls

Kept from Upstream

• Google Ads / LSA management
• Meta Ads (Facebook/Instagram)
• Google Search Console
• Buffer (social scheduling)
• Hotjar (CRO heatmaps)
• Newsletter tools (Mailchimp/Kit)

See tools/REGISTRY.md for full tool index.

Validation

./validate-skills.sh    # All 38 skills must pass

License

MIT — forked from coreyhaines31/marketingskills.