# HVAC Marketing Skills — Claude Code Instructions

## What This Repo Is

38 HVAC marketing skills for AI agents, forked from [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills). Each skill is a SKILL.md file in `skills/{name}/`.

## Key Files

- `COMPENDIUM_INTEGRATION.md` — Database queries, API endpoints, fallback behavior
- `AGENTS.md` — Skill format spec and contribution guidelines
- `VERSIONS.md` — Skill version tracking
- `.claude-plugin/marketplace.json` — Plugin manifest

## Working With Skills

- Foundation skill is `hvac-marketing-context` — all others reference it
- Skills declare `compendium.mode` in frontmatter: `standalone`, `enhanced`, or `required`
- When Compendium services are unavailable, fall back to `WebSearch`/`WebFetch`
- SKILL.md files must stay under 500 lines

## Validation

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

## Git

- `upstream` remote = GitHub (read-only)
- `local` remote = Gitea (`http://192.168.10.31:3005/ben/hvac-marketing-skills.git`)
- Push only to `local`