# HVAC Marketing Skills for AI Agents

HVAC-adapted marketing skills for AI coding agents, forked from [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills) (MIT license). Every skill has been adapted for the HVAC industry with deep integration into the [Compendium](https://git.tealmaker.com/ben/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](https://agentskills.io).

## Upstream Credit

Original marketing skills by [Corey Haines](https://corey.co) — 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](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](skills/hvac-content-from-data/) | Create content directly from Compendium database intelligence |
| [hvac-seasonal-campaign](skills/hvac-seasonal-campaign/) | Seasonal marketing tied to HVAC demand cycles |
| [hvac-review-management](skills/hvac-review-management/) | Google Business Profile review strategy |
| [hvac-video-repurpose](skills/hvac-video-repurpose/) | Repurpose long-form video/podcast content for social |
| [hvac-technical-content](skills/hvac-technical-content/) | Write technical HVAC content at the right level |
| [hvac-brand-voice](skills/hvac-brand-voice/) | Brand voice and personality guide for HVAC brands |
| [hvac-contractor-website-audit](skills/hvac-contractor-website-audit/) | Contractor website discovery and analysis |
| [hvac-contractor-website-package](skills/hvac-contractor-website-package/) | Marketing package assembly from audit data |
| [hvac-compliance-claims](skills/hvac-compliance-claims/) | EPA/rebate/safety claim checking |
| [hvac-content-qc](skills/hvac-content-qc/) | Content quality control and citation verification |

### Foundation
| Skill | Description |
|-------|-------------|
| [hvac-marketing-context](skills/hvac-marketing-context/) | Foundation doc — brand profiles, audience segments, HVAC calendar |

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

### Content & Copy
| Skill | Description |
|-------|-------------|
| [content-strategy](skills/content-strategy/) | HVAC content pillars and gap analysis |
| [copywriting](skills/copywriting/) | HVAC voice guide with real quote sourcing |
| [copy-editing](skills/copy-editing/) | Edit and polish existing copy |
| [social-content](skills/social-content/) | Platform-specific HVAC social content |
| [email-sequence](skills/email-sequence/) | HVAC newsletter and maintenance sequences |
| [cold-email](skills/cold-email/) | B2B outreach for distributors and manufacturers |

### CRO & Conversion
| Skill | Description |
|-------|-------------|
| [page-cro](skills/page-cro/) | HVAC service page optimization |
| [form-cro](skills/form-cro/) | Quote request and scheduling forms |
| [hvac-estimate-popups](skills/hvac-estimate-popups/) | Estimate request popups and seasonal CTAs |

### Paid & Measurement
| Skill | Description |
|-------|-------------|
| [paid-ads](skills/paid-ads/) | Local Service Ads and seasonal campaigns |
| [ad-creative](skills/ad-creative/) | HVAC ad creative with seasonal messaging |
| [analytics-tracking](skills/analytics-tracking/) | HVAC conversion tracking |
| [ab-test-setup](skills/ab-test-setup/) | A/B testing for HVAC pages |

### Strategy & Growth
| Skill | Description |
|-------|-------------|
| [marketing-ideas](skills/marketing-ideas/) | HVAC marketing tactics and campaigns |
| [marketing-psychology](skills/marketing-psychology/) | Psychology applied to HVAC marketing |
| [pricing-strategy](skills/pricing-strategy/) | HVAC service pricing strategy |
| [referral-program](skills/referral-program/) | Contractor referral programs |
| [free-tool-strategy](skills/free-tool-strategy/) | HVAC calculators and estimators |
| [launch-strategy](skills/launch-strategy/) | HVAC service and product launches |

### Sales & Operations
| Skill | Description |
|-------|-------------|
| [hvac-lead-ops](skills/hvac-lead-ops/) | Intake-to-booked-job funnel management |
| [sales-enablement](skills/sales-enablement/) | Equipment proposals and maintenance pitches |

## Installation

### Clone and Copy (Recommended)

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

### Git Submodule

```bash
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](tools/REGISTRY.md) for full tool index.

## Validation

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

## License

[MIT](LICENSE) — forked from [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills).