ben/hvac-marketing-skills
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
hvac-marketing-skills/README.md
bengizmo 1e70d8387b
Some checks failed
Sync Skills / sync (push) Has been cancelled
Details
Validate Agent Skill / detect-changes (push) Has been cancelled
Details
Validate Agent Skill / validate (push) Has been cancelled
Details
feat: fork marketingskills → HVAC Marketing Skills for Compendium 
- Forked from coreyhaines31/marketingskills v1.1.0 (MIT license)
- Removed 4 SaaS-only skills (churn-prevention, paywall-upgrade-cro, onboarding-cro, signup-flow-cro)
- Reworked 2 skills (popup-cro → hvac-estimate-popups, revops → hvac-lead-ops)
- Adapted all 28 retained skills with HVAC industry context and Compendium integration
- Created 10 new HVAC-specific skills:
  - hvac-content-from-data (flagship DB integration)
  - hvac-seasonal-campaign (demand cycle marketing)
  - hvac-review-management (GBP review strategy)
  - hvac-video-repurpose (long-form → social)
  - hvac-technical-content (audience-calibrated writing)
  - hvac-brand-voice (trade authenticity guide)
  - hvac-contractor-website-audit (discovery & analysis)
  - hvac-contractor-website-package (marketing package assembly)
  - hvac-compliance-claims (EPA/rebate/safety claim checking)
  - hvac-content-qc (fact-check & citation gate)
- Renamed product-marketing-context → hvac-marketing-context (global)
- Created COMPENDIUM_INTEGRATION.md (shared integration contract)
- Added Compendium wrapper tools (search, scrape, classify)
- Added compendium capability tags to YAML frontmatter
- Updated README, AGENTS.md, CLAUDE.md, VERSIONS.md, marketplace.json
- All 38 skills pass validate-skills.sh
- Zero dangling references to removed/renamed skills

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 21:05:49 -03:00

183 lines
8.8 KiB
Markdown
Raw Permalink Blame History

# 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).
Reference in a new issue View git blame Copy permalink