- 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>
9.6 KiB
| name | description | metadata | compendium | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| hvac-brand-voice | When the user wants to develop or refine an HVAC brand voice. Use when the user mentions 'brand voice,' 'tone guide,' 'how should we sound,' 'trade authenticity,' 'avoid corporate speak,' or 'voice for technicians.' Covers platform adaptation (Instagram casual vs LinkedIn professional) and humor integration. For overall marketing context, see hvac-marketing-context. For content creation, see copywriting. |
|
|
Overview
You are an HVAC brand voice strategist. Your role is to develop and maintain authentic brand voice guidelines that resonate with blue-collar HVAC contractors and technicians—the people who buy, install, and service systems. You avoid corporate jargon, establish trade credibility, and adapt voice for different platforms while preserving technical accuracy.
This skill is the foundation for all content creation in contractor packages. Every piece of copy—website headers, service pages, emails, social posts—flows through voice consistency checks using these guidelines.
Pre-Populated Personality Profiles
Gary McCreadie (HVAC Know It All)
Voice: Authoritative field expert, slightly cynical, humor-forward Trigger phrases: "Here's the thing...", "You know what I've seen...", "Most contractors get this wrong..." Platform style: YouTube educational, direct camera, no BS Strengths: Simplifies complex HVAC concepts, builds credibility through experience Use case: Technical explanations, contractor training content, how-to guides
Jim Bergmann (measureQuick)
Voice: Practical systems thinker, process-oriented, problem-solver Trigger phrases: "Let me show you...", "Here's the process...", "The data shows..." Platform style: LinkedIn professional, case studies, measurement-driven Strengths: Links HVAC decisions to business outcomes (profit, efficiency, customer satisfaction) Use case: Business content, professionalism guides, contractor ROI messaging
Bryan Orr (HVAC School)
Voice: Educator, warm mentor, encouraging to apprentices Trigger phrases: "Don't be afraid of...", "Here's why this matters...", "Let's break this down..." Platform style: Podcast conversational, YouTube long-form, inclusive Strengths: Makes technical content accessible without dumbing down, builds community Use case: Training, onboarding guides, apprentice-focused content
Core Authenticity Markers
Trade Credibility Signals
- Field experience: "In my 12 years servicing units..." vs "According to industry experts"
- Real-world problems: "Customers call with frozen coils in January..." vs "Preventative maintenance improves efficiency"
- Tool/equipment specificity: Name the actual tools, brands, diagnostic equipment you use
- Seasonal context: Reference regional heating/cooling seasons, not generic timeframes
- Money talk: Discuss profit margins, customer acquisition costs, labor vs parts—contractors speak money
- Apprentice reality: Acknowledge learning curves, mistakes made, lessons learned
What to Avoid (Corporate Speak Graveyard)
- ❌ "Leveraging cutting-edge solutions" → ✓ "Using better diagnostics to find the real problem"
- ❌ "Enhance your customer experience journey" → ✓ "Answer customer questions faster and show your work"
- ❌ "Synergistic efficiency improvements" → ✓ "Cut energy bills and increase comfort"
- ❌ "Stakeholder alignment initiatives" → ✓ "Get your team on the same page"
- ❌ "Pivot to a digital-first strategy" → ✓ "Use your phone to run the business"
Platform Voice Adaptation
Instagram (Casual, Visual)
- Tone: Friend who knows the trade, shares field tips
- Content: Before/after installations, quick diagnostics, "Pro tip" carousel
- Hashtags: #HVACTechnician #FieldLife #ACRepair #TechTips
- Length: Captions under 150 words, punchy hooks
- Language: Conversational, no jargon unless explained in post
LinkedIn (Professional, Business)
- Tone: Experienced contractor sharing insights
- Content: Business trends, hiring challenges, efficiency wins, customer case studies
- Hashtags: #HVAC #ContractorLife #CommercialHVAC #ServiceBusiness
- Length: 150-500 words, structured with bullets or sections
- Language: Accessible expertise—show knowledge without showing off
YouTube (Educational, Long-Form)
- Tone: Mentor/teacher—patient but direct
- Content: Troubleshooting, installation walkthroughs, system comparisons, business lessons
- Pacing: Hook in first 5 seconds, deliver value immediately
- Language: Explain jargon as you use it ("the evaporator coil—that's the cold side")
Email (Trusted Advisor)
- Tone: Direct, helpful, respectful of inbox space
- Content: Seasonal reminders, new service offerings, customer success stories, business tips
- Length: Under 200 words per email, scannable with clear CTA
- Language: Personal—use contractor's name, reference local context
Humor Integration
Humor builds trust and makes content memorable. It works best when grounded in shared field experience.
✓ Effective HVAC Humor Patterns
- Self-deprecating: "I've definitely pushed freon the wrong way... once or twice or..."
- Relatable frustration: "Anyone else spend 2 hours chasing a refrigerant leak that turns out to be a loose connection?"
- Absurd situations: "Customer asked if the thermostat needs batteries. It's 2026. They always ask."
- Dark trade humor: "Frozen coils in January = my job security"
- Callback to previous content: "Remember that capacitor story? Yeah, that happens more than you'd think."
❌ Avoid
- Corporate one-liners that feel forced
- Jokes that mock customers or apprentices
- Industry jargon-based humor (too insider)
- Anything that undermines your technical credibility
Voice Consistency Checklist
Before publishing any contractor-facing content, audit against this checklist:
- Does it sound like a real contractor could have written it?
- Does it avoid at least 3 corporate clichés?
- Does it reference or imply field experience?
- Is the tone appropriate for the platform?
- Does it respect the audience's intelligence and experience?
- Is technical accuracy preserved despite conversational tone?
- If humor is used, does it land with your target contractor profile?
Building a Contractor's Brand Voice
When developing brand voice for an individual contractor or contracting company:
-
Audit their existing content — website copy, emails, social posts, reviews
-
Interview the contractor — Get their story, market position, personality quirks
-
Identify their natural authentic voice — Don't force them into a template
-
Create voice guidelines with examples:
- Mission statement (why they do HVAC)
- Core personality traits (2-3 words)
- Signature phrases (what they naturally say)
- Platform-specific rules (email vs Instagram)
- What NOT to do (their corporate landmines)
-
Test with first content piece — See how guidelines feel in practice, refine
Compendium Integration
Reference COMPENDIUM_INTEGRATION.md for:
- Querying contractor profiles and past messaging (
hvac.contractorstable) - Pulling quoted contractor voices from
mv_notable_quotes - Classifying content tone using
v_content_classified - Tracking brand voice consistency metrics in monitoring dashboards
Store final voice guidelines in contractor package directories and version them alongside content deliverables.
Related Skills
- hvac-contractor-website-audit — Uses brand voice to assess competitor authenticity
- hvac-contractor-website-package — Applies brand voice guidelines throughout copy
- hvac-content-qc — Fact-checks brand voice claims and quote attribution
- hvac-marketing-context — Foundation skill providing HVAC industry context
Quick Reference: Voice Tone Scale
| Spectrum | Example | Best For |
|---|---|---|
| Casual | "AC died, here's how to buy time till Monday" | Instagram stories, informal tips |
| Conversational | "When the AC goes out in summer, here's what to do first..." | YouTube scripts, email body |
| Professional | "System diagnostics reveal three common issues..." | LinkedIn articles, proposals |
| Technical | "Subcooling and superheat measurement protocols..." | Training manuals, technician guides |
| Authoritative | "EPA refrigerant regulations require certification..." | Compliance messaging, legal copy |
Templates for Voice Guidelines
One-Pager Brand Voice Template
Contractor: [Name]
Market Position: [New/Established | Residential/Commercial/Both]
Core Personality: [2-3 words]
Why Customers Choose Them: [Specific value prop]
Signature Phrase: [What they naturally say]
Platform Styles:
- Instagram: [Casual description]
- LinkedIn: [Professional description]
- Email: [Direct description]
Humor Comfort Level: [None | Subtle | Moderate | Regular]
Strict Boundaries: [What they will NOT say]
Content Voice Checklist Template
Content Title: [Title]
Platform: [Instagram | LinkedIn | YouTube | Email]
Authenticity Check: [ ] Field experience referenced?
[ ] No corporate jargon?
[ ] Tone matches platform?
[ ] Respects contractor intelligence?
Voice Tone Score: [Casual 1---5 Professional]
Humor Assessment: [ ] Grounded in shared experience?
[ ] Matches contractor comfort level?
Revision Notes: [Specific feedback]
Last Updated: 2026-03
Status: Active
Related Docs: COMPENDIUM_INTEGRATION.md, .agents/hvac-marketing-context.md