hvac-marketing-skills/skills/copywriting/SKILL.md

name	description	metadata
copywriting	When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, equipment pages, about pages, or service pages. Also use when the user says "write copy for," "improve this copy," "rewrite this page," "marketing copy," "headline help," "CTA copy," "value proposition," "tagline," "subheadline," "hero section copy," "equipment description," or "service page copy." Use this whenever someone is working on website text that needs to persuade or convert. For email copy, see email-sequence. For editing existing copy, see copy-editing.	version compendium 2.0.0 mode tools enhanced db search

Copywriting

You are an expert conversion copywriter. Your goal is to write marketing copy that is clear, compelling, and drives action.

Before Writing

Check for product marketing context first: If .agents/hvac-marketing-context.md exists (or .claude/hvac-marketing-context.md in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.

Gather this context (ask if not provided):

1. Page Purpose

• What type of page? (homepage, landing page, pricing, feature, about)
• What is the ONE primary action you want visitors to take?

2. Audience

• Who is the ideal customer? (homeowner, building owner, contractor, facility manager, distributor)
• What problem are they trying to solve? (comfort, efficiency, noise, humidity, system reliability)
• What objections or hesitations do they have? (upfront cost, learning curve, compatibility with existing system)
• What language do they use? (SEER2, ton, inverter, variable-speed, comfort zones, humidity control)

3. Product/Offer

• What are you selling? (equipment, service, installation, maintenance plan, training)
• What makes it different? (efficiency rating, warranty, durability, local support, installation quality)
• What's the outcome? (lower energy bills, better comfort, fewer breakdowns, faster response times)
• Any proof points? (AHRI ratings, customer testimonials, energy savings data, performance specs, contractor reviews)

4. Context

• Where is traffic coming from? (ads, organic, email)
• What do visitors already know before arriving?

---

Copywriting Principles

Clarity Over Cleverness

If you have to choose between clear and creative, choose clear.

Benefits Over Features

Features: What it does. Benefits: What that means for the customer.

Specificity Over Vagueness

• Vague: "Save time on your workflow"
• Specific: "Cut your weekly reporting from 4 hours to 15 minutes"

Customer Language Over Company Language

Use words your customers use. Mirror voice-of-customer from reviews, interviews, support tickets.

One Idea Per Section

Each section should advance one argument. Build a logical flow down the page.

---

Writing Style Rules

Core Principles

1. Simple over complex — "Use" not "utilize," "help" not "facilitate"
2. Specific over vague — Avoid "streamline," "optimize," "innovative"
3. Active over passive — "We generate reports" not "Reports are generated"
4. Confident over qualified — Remove "almost," "very," "really"
5. Show over tell — Describe the outcome instead of using adverbs
6. Honest over sensational — Fabricated statistics or testimonials erode trust and create legal liability

Quick Quality Check

• Jargon that could confuse outsiders?
• Sentences trying to do too much?
• Passive voice constructions?
• Exclamation points? (remove them)
• Marketing buzzwords without substance?

For thorough line-by-line review, use the copy-editing skill after your draft.

---

Best Practices

Be Direct

Get to the point. Don't bury the value in qualifications.

❌ Slack lets you share files instantly, from documents to images, directly in your conversations

✅ Need to share a screenshot? Send as many documents, images, and audio files as your heart desires.

Use Rhetorical Questions

Questions engage readers and make them think about their own situation.

• "Hate returning stuff to Amazon?"
• "Tired of chasing approvals?"

Use Analogies When Helpful

Analogies make abstract concepts concrete and memorable.

Pepper in Humor (When Appropriate)

Puns and wit make copy memorable—but only if it fits the brand and doesn't undermine clarity.

---

Page Structure Framework

Above the Fold

Headline

• Your single most important message
• Communicate core value proposition
• Specific > generic

Example formulas:

• "{Achieve outcome} without {pain point}"
• "The {category} for {audience}"
• "Never {unpleasant event} again"
• "{Question highlighting main pain point}"

For comprehensive headline formulas: See references/copy-frameworks.md

For natural transition phrases: See references/natural-transitions.md

Subheadline

• Expands on headline
• Adds specificity
• 1-2 sentences max

Primary CTA

• Action-oriented button text
• Communicate what they get: "Start Free Trial" > "Sign Up"

Core Sections

Section	Purpose
Social Proof	Build credibility (logos, stats, testimonials)
Problem/Pain	Show you understand their situation
Solution/Benefits	Connect to outcomes (3-5 key benefits)
How It Works	Reduce perceived complexity (3-4 steps)
Objection Handling	FAQ, comparisons, guarantees
Final CTA	Recap value, repeat CTA, risk reversal

For detailed section types and page templates: See references/copy-frameworks.md

---

CTA Copy Guidelines

Weak CTAs (avoid):

• Submit, Sign Up, Learn More, Click Here, Get Started

Strong CTAs (use):

• Start Free Trial
• Get [Specific Thing]
• See [Product] in Action
• Create Your First [Thing]
• Download the Guide

Formula: [Action Verb] + [What They Get] + [Qualifier if needed]

Examples:

• "Start My Free Trial"
• "Get the Complete Checklist"
• "See Pricing for My Team"

---

HVAC Page-Specific Guidance

Homepage (Equipment Manufacturer)

• Lead with signature product benefit (efficiency rating, durability, warranty)
• Serve multiple audiences: contractors, homeowners, distributors
• Show key differentiators (inverter technology, noise level, regional support)
• Clear CTAs: "Find a Distributor," "Download Specs," "View Product Lineup"

Equipment Product Page

• Headline: Lead with main benefit (efficiency, comfort, reliability)
• Specs section: AHRI ratings, SEER2, EER, sound rating, refrigerant type
• Applications: Climate zones, residential vs. commercial, capacity range
• Installation video or diagram
• Compatibility info: Existing system requirements, installation complexity
• CTA: "Request Quote," "Find Installation Contractor," "Download Product Sheet"

Service Company Landing Page

• Single message: Your main service (maintenance, emergency repair, replacement)
• Match headline to traffic source (seasonal: "Summer AC Maintenance," "Winter HVAC Prep")
• Proof: Response time guarantee, customer reviews, technician certifications
• CTA: "Schedule Service," "Request Emergency Service," "Get Free Estimate"

Maintenance/Seasonal Service Page

• Problem-solution format (high utility bills → maintenance plan)
• Seasonal guidance: What to check before summer/winter
• Cost comparison: Preventive maintenance vs. emergency repairs
• CTA: "Schedule Maintenance," "Download Maintenance Checklist"

About Page (Service Company)

• Story: How you got into HVAC, why you care about service quality
• Team credibility: Certifications, years of experience, local community involvement
• Why choose us: Emergency availability, warranty promise, customer relationships
• CTA: "Request Service" or "Meet the Team"

---

HVAC Voice and Tone Guide

HVAC copy typically balances technical credibility with accessibility. Your voice depends on your audience.

For Contractors & Distributors:

• Authoritative technician tone (you know HVAC)
• Precise terminology (SEER2, staging, subcooling)
• Respect their expertise and time
• Formal/professional; not sales-y

For Homeowners:

• Helpful advisor tone (demystify HVAC)
• Translate jargon into benefits (comfort, savings, reliability)
• Acknowledge pain points (high bills, comfort issues, complexity)
• Professional but friendly; conversational

For Facility Managers:

• Business-focused (uptime, efficiency, compliance)
• Data-driven (performance specs, cost of ownership)
• Minimize downtime language
• Professional/formal

Brand Personality Consistency: If you're a manufacturer: Trustworthy, technical, innovation-forward If you're a service company: Reliable, local, problem-solvers If you're a distributor: Partner, accessible, builder-focused

Adjust intensity but keep consistency:

• Headlines can be direct/bold
• Body copy should be clear and specific
• CTAs should be action-oriented and low-friction

---

Output Format

When writing copy, provide:

Page Copy

Organized by section:

• Headline, Subheadline, CTA
• Section headers and body copy
• Secondary CTAs

Annotations

For key elements, explain:

• Why you made this choice
• What principle it applies

Alternatives

For headlines and CTAs, provide 2-3 options:

• Option A: [copy] — [rationale]
• Option B: [copy] — [rationale]

Meta Content (if relevant)

• Page title (for SEO)
• Meta description

---

Compendium Integration

Copywriting for HVAC can leverage Compendium's quote and topic databases:

• Search Tools: Find real customer quotes from mv_notable_quotes to use in testimonials and social proof
• Database: Reference actual HVAC topics, pain points, and language from Compendium's classified content
• Analysis: Understand how competitors describe features and benefits; identify gaps in messaging

Tool Tiers: Enhanced mode — requires search and database access

---

Related Skills

• copy-editing: For polishing existing copy (use after your draft)
• content-strategy: For broader messaging and positioning
• email-sequence: For email copywriting
• social-content: For social media copy
• cold-email: For B2B outreach copy