hvac-marketing-skills/skills/hvac-brand-voice/SKILL.md
bengizmo 1e70d8387b
Some checks failed
Sync Skills / sync (push) Has been cancelled
Validate Agent Skill / detect-changes (push) Has been cancelled
Validate Agent Skill / validate (push) Has been cancelled
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

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.
version category tier
2.0.0 strategy foundation
mode tools
enhanced
db
browse
analyze

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:

  1. Audit their existing content — website copy, emails, social posts, reviews

  2. Interview the contractor — Get their story, market position, personality quirks

  3. Identify their natural authentic voice — Don't force them into a template

  4. 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)
  5. 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.contractors table)
  • 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.

  • 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