copywriting-spec

name	copywriting-spec
description	Create comprehensive copywriting specification document for a brand through structured interviews
disable-model-invocation	true

Configuration

Read .jobops/config.json. If missing, stop with:

JOBOPS NOT CONFIGURED Run /jobops:setup (then /jobops-ic:setup) to initialize your workspace.

Use config.directories.contractor_root for output paths in this skill. Use config.preferences.default_currency for pricing if applicable.

Create Copywriting Specification

Generate a comprehensive copywriting specification document for a brand, using structured interviews to gather requirements.

Arguments

• $ARGUMENTS - Company/brand name (optional - will prompt if not provided)

Instructions

You are an expert brand strategist and copywriter creating a comprehensive copywriting specification document.

Process Overview

This is an interactive interview process. You will gather information across 8 phases, asking targeted questions and providing examples to guide responses. After gathering all information, generate the complete specification document using the embedded template structure below.

IMPORTANT: Do NOT load or reference any external files as templates. Use only the structure defined in this command file.

---

Phase 1: Brand Identity

Questions to Ask

1. Company Name: What is the company/brand name?

2. Principal/Leadership: Who is the principal or key leader? Include:

   • Full name
   • Professional credentials (certifications, designations)
   • Title/role

3. Positioning Statement: How would you describe what the company does in one sentence?

   • Example: "Institutional-grade operational optimization for commercial real estate and infrastructure"

4. Tagline: Do you have a tagline or would you like to develop one?

   • Example: "Institutional Experience. Technical Execution."

---

Phase 2: Target Audience

Questions to Ask

1. Primary Audience: Who are your ideal clients? List specific:

   • Job titles (e.g., CFO, CIO, VP Operations)
   • Organization types (e.g., Fortune 500, startups, government)
   • Decision-making authority level

2. Audience Characteristics: Describe your audience's:

   • Sophistication level: How educated/experienced are they in your domain?
   • Decision style: How do they make purchasing decisions? (committee, individual, evidence-based, relationship-based)
   • Time constraints: How much time do they have to evaluate options?
   • Pain tolerance: What marketing approaches turn them off?
   • Trust signals: What makes them trust a vendor/partner?

3. Industries Served: Which industries or sectors do you serve?

---

Phase 3: Voice & Tone

Questions to Ask

1. Brand Voice Archetype: Which best describes how you want to sound?

   • Authoritative Peer: Credentialed expert speaking to equals
   • Trusted Advisor: Experienced guide helping navigate complexity
   • Innovative Disruptor: Bold challenger of the status quo
   • Friendly Expert: Approachable specialist making complex simple
   • Premium Partner: Exclusive, high-end service provider
   • Other: Describe your ideal voice

2. Tone Spectrum: Where does your brand sit on these spectrums? (1-10 scale)

   Casual (1) <-------------------> Formal (10)
   Enthusiastic (1) <--------------> Reserved (10)
   Salesy (1) <--------------------> Consultative (10)
   Technical (1) <-----------------> Accessible (10)
   Bold (1) <----------------------> Understated (10)
   

3. Emotional Register: Which emotions are appropriate for your brand?

   • Confidence (quiet vs. bold)
   • Urgency (market-driven vs. artificial)
   • Empathy/concern
   • Enthusiasm/excitement
   • Authority/expertise

---

Phase 4: Language Guidelines

Questions to Ask

1. Industry Terminology: What domain-specific terms should be used?

   • List technical terms your audience uses daily
   • List terms that signal insider knowledge

2. Words to AVOID: What language turns off your audience?

   • Buzzwords they're tired of
   • Competitor language you want to differentiate from
   • Casual terms inappropriate for your audience
   • Hyperbole that would undermine credibility

3. Tone Violations: What would sound "off-brand"?

   • Too casual examples
   • Too salesy examples
   • Too technical examples

4. CTA Language: How should calls-to-action be phrased?

   • Example: "Schedule a Consultation" not "Book a Quick Call"

---

Phase 5: Messaging Hierarchy

Questions to Ask

1. Primary Message: What is the ONE thing you want people to remember?

2. Credentials: What credentials/qualifications should be emphasized?

   • Professional designations
   • Years of experience
   • Notable clients/projects
   • Unique qualifications

3. Track Record: What specific results can you cite?

   • Quantified outcomes (%, $, time saved)
   • Scale indicators (# of clients, projects, assets)
   • Comparison benchmarks

4. Capabilities: What services/capabilities should be highlighted?

5. Message Sequencing: Should messaging change based on audience familiarity?

   • Cold prospects: What do they need to hear first?
   • Warm leads: What resonates after initial interest?
   • Hot prospects: What closes the deal?

---

Phase 6: Proof Points

Questions to Ask

For each major achievement or metric (gather 5-10):

1. What is the metric? (e.g., "141% portfolio returns")
2. What is the context? (e.g., "vs. 35% market benchmark")
3. Where did this occur? (e.g., "at Company X")
4. What caused this result? (e.g., "disciplined asset management")
5. When should this be used? (e.g., "investment credibility discussions")

---

Phase 7: Competitor Differentiation

Questions to Ask

1. Competitor Types: Who do prospects compare you to?

   • Direct competitors (same service)
   • Adjacent competitors (different approach, same problem)
   • Alternative solutions (DIY, in-house, status quo)

2. Their Positioning: How do these competitors position themselves?

3. Your Differentiation: What makes you different from each?

4. Competitive Messaging: What specific phrases counter each competitor type?

---

Phase 8: Channel & Format Requirements

Questions to Ask

1. Active Channels: Which communication channels will you use?

   • Website/landing pages
   • Email (cold outreach, warm follow-up, nurture)
   • LinkedIn
   • Proposals/decks
   • Case studies
   • Advertising

2. Channel-Specific Needs: For each active channel:

   • Length constraints
   • Tone variations
   • Specific dos/don'ts

3. Communication Conventions: Preferences for:

   • Email openings/closings
   • Signature blocks
   • Meeting follow-ups

---

Output Document Template

After gathering all information, generate a complete copywriting specification document following this EXACT structure:

# [Company Name] -- Copywriting Specification

**Version:** 1.0
**Last Updated:** [Current Date]
**Purpose:** Define brand voice, tone, and language guidelines for all [Company] communications

---

## Table of Contents

1. [Brand Identity](#1-brand-identity)
2. [Target Audience](#2-target-audience)
3. [Voice & Tone](#3-voice--tone)
4. [Person & Voice Conventions](#4-person--voice-conventions)
5. [Sentence & Paragraph Structure](#5-sentence--paragraph-structure)
6. [Language Guidelines](#6-language-guidelines)
7. [Formatting Standards](#7-formatting-standards)
8. [Messaging Hierarchy](#8-messaging-hierarchy)
9. [Value Proposition Variants](#9-value-proposition-variants)
10. [Copy Formulas](#10-copy-formulas)
11. [Problem Articulation Library](#11-problem-articulation-library)
12. [Section-by-Section Guidelines](#12-section-by-section-guidelines)
13. [Proof Point Library](#13-proof-point-library)
14. [Competitor Differentiation](#14-competitor-differentiation)
 []()
 []()
 []()
 []()
 []()
 []()

---




 : [Company Name]
 : [Name, Credentials]
 : [One-sentence positioning statement]
 : [Tagline]


[What the company promises to deliver]


[3-5 personality traits that define how the brand behaves]

---




| Attribute | Description |
|-----------|-------------|
| Job Titles | [List titles] |
| Organizations | [Organization types] |
| Decision Authority | [Level] |
| Budget Range | [Typical engagement size] |


 : [Description]
 : [How they decide]
 : [Available attention]
 : [What they reject]
 : [What builds credibility]


[List of industries/sectors]

---




: [Description of how this manifests]


| Dimension | Position (1-10) | Implication |
|-----------|-----------------|-------------|
| Casual <-> Formal | [X] | [What this means in practice] |
| Enthusiastic <-> Reserved | [X] | [What this means in practice] |
| Salesy <-> Consultative | [X] | [What this means in practice] |
| Technical <-> Accessible | [X] | [What this means in practice] |
| Bold <-> Understated | [X] | [What this means in practice] |


: [List with guidance on intensity]

: [List what to avoid]

---




 : [First person plural "we" / First person singular "I" / Third person]
 : [Guidance on context-dependent shifts]


 : Active voice
 : [Specific situations]


 : [Use freely / Use sparingly / Avoid]
 : [Any specific cases]

---




| Type | Target Length | Maximum |
|------|---------------|---------|
| Headlines | [X] words | [X] words |
| Subheadlines | [X] words | [X] words |
| Body copy | [X-X] words | [X] words |
| CTAs | [X] words | [X] words |


 : [X] sentences / [X] lines
 : [X] sentences / [X] lines
 : Lead with key point, support, conclude


 Vary sentence length for readability
 Use short sentences for emphasis
 Use longer sentences for complex ideas (but stay under maximum)

---




| Use This | Instead Of | Reason |
|----------|------------|--------|
| [Preferred term] | [Avoided term] | [Why] |
| [Preferred term] | [Avoided term] | [Why] |
| [Preferred term] | [Avoided term] | [Why] |


[List of industry terms that signal expertise]


| Category | Avoid | Reason |
|----------|-------|--------|
| Buzzwords | [List] | [Why] |
| Hyperbole | [List] | [Why] |
| Casual | [List] | [Why] |
| Competitor language | [List] | [Why] |


| Context | Approved | Avoid |
|---------|----------|-------|
| Primary conversion | [Examples] | [Examples] |
| Secondary action | [Examples] | [Examples] |
| Soft engagement | [Examples] | [Examples] |

---




| Type | Format | Example |
|------|--------|---------|
| Percentages | [Format] | [Example] |
| Currency | [Format] | [Example] |
| Large numbers | [Format] | [Example] |
| Ranges | [Format with en dash] | [Example] |
| Years of experience | [Format] | [Example] |


 : [Yes/No]
 : Use for ranges (dates, numbers, prices)
 : Use for emphasis or parenthetical statements
 : [Policy]


 : [Sentence case / Title case]
 : [Sentence case / Title case]
 : [Sentence case / Title case]
 : [Policy]

---




[The ONE thing prospects should remember]


 : [Key qualifications]
 : [Proof of results]
 : [What you deliver]
 : [Why you vs. alternatives]




 [First message priority]
 [Second message priority]
 [Third message priority]


 [First message priority]
 [Second message priority]
 [Third message priority]


 [First message priority]
 [Second message priority]
 [Third message priority]

---




[Concise value proposition in exactly 10 words]


[Expanded value proposition in approximately 30 words]


[Fuller value proposition in approximately 50 words]


[Detailed value proposition in approximately 75 words]


[Comprehensive value proposition in approximately 150 words]

---




: [Problem/Outcome] + [Mechanism/Differentiator]
: [Specific example using company content]


: [Expand on headline] + [Proof element or specific benefit]
: [Specific example using company content]


:
 Hook (acknowledge situation)
 Problem (articulate pain)
 Agitate (consequences of inaction)
 Solution (introduce approach)
 Proof (evidence it works)
 CTA (clear next step)


: [Action verb] + [Value received] + [Urgency/ease element]
: [Specific example using company content]

---




| Element | Content |
|---------|---------|
|  | [List of approved ways to describe this pain] |
|  | [Phrasing that's too dramatic or off-brand] |
|  | [Data or proof this is a real problem] |
|  | [What happens if not addressed] |


[Same structure as above]


[Same structure as above]


[Same structure as above]

---




 : [X] words max, problem-focused or outcome-focused
 : [X] words max, expand with proof element
 : [Placement and content guidance]
 : [Primary and secondary guidance]


 : [Guidance on intensity]
 : [Number of pain points, format]
 : [Guidance]


 : [Credibility or capability]
 : [Length and format]
 : [How to weave in evidence]


 : [X]
 : [Title + description length]
 : [What to include]


 : [Format guidance]
 : [Structure]
 : [How to present]


 : [Guidance]
 : [Required elements]
 : [Optional guidance]

---




| Element | Content |
|---------|---------|
|  | [The number/result] |
|  | [Comparison or benchmark] |
|  | [Where this occurred] |
|  | [What caused this result] |
|  | [Appropriate contexts] |
|  | [2-3 ways to express this] |


[Same structure]


[Same structure]

[Continue for all proof points gathered]

---




| Element | Content |
|---------|---------|
|  | [Their positioning] |
|  | [Our counter-positioning] |
|  | [Specific advantage] |
|  | [Evidence of our advantage] |
|  | [Exact language to use] |


[Same structure]


[Same structure]

---




| Element | Content |
|---------|---------|
|  | [How to validate the concern] |
|  | [How to shift perspective] |
|  | [Proof that addresses this] |
|  | [Exact language to use] |


[Same structure]


[Same structure]

---




 : [Any shifts from default]
 : [Specific guidance]
 : [Platform-specific notes]


 : [Formula and length]
 : [Approach]
 : [Format]
 : [Type and placement]
 : [Word/sentence count]
 : [Any adjustments]


 : [Guidance]
 : [Structure]
 : [Approach]
 : [Format]
 : [Any adjustments]


 : [Any shifts]
 : [Key sections]
 : [Per section]
 : [Guidance]


 : [Situation, Challenge, Solution, Result]
 : [Target word count]
 : [How to present metrics]
 : [How to handle quotes]

---




| Context | Approved | Avoid |
|---------|----------|-------|
| First contact | [Examples] | [Examples] |
| Follow-up | [Examples] | [Examples] |
| Existing relationship | [Examples] | [Examples] |


| Context | Approved | Avoid |
|---------|----------|-------|
| Requesting action | [Examples] | [Examples] |
| Providing information | [Examples] | [Examples] |
| Building relationship | [Examples] | [Examples] |

[Standard signature format]

### Meeting Follow-ups
- **Timing**: [When to send]
- **Structure**: [Key elements]
- **Tone**: [Guidance]

---

## 18. Quality Checklist

### Before Publishing Any Copy

#### Voice & Tone
- [ ] Matches [archetype] voice archetype
- [ ] Tone appropriate for channel and audience temperature
- [ ] No tone violations (too casual, too salesy, too technical)

#### Language
- [ ] Uses approved terminology (see Section 6)
- [ ] Avoids banned words and phrases
- [ ] Domain-specific terms used appropriately

#### Structure
- [ ] Sentences within length limits ([X] words max)
- [ ] Paragraphs within length limits ([X] sentences max)
- [ ] Varied sentence rhythm

#### Formatting
- [ ] Numbers formatted per standards
- [ ] En dashes used for ranges
- [ ] Capitalization follows guidelines
- [ ] Serial comma [used/not used] consistently

#### Messaging
- [ ] Primary message clear
- [ ] Proof points properly contextualized
- [ ] CTA uses approved language
- [ ] Credentials/authority established appropriately

#### Channel-Specific
- [ ] Length appropriate for channel
- [ ] Tone adjusted per channel guidelines
- [ ] Format follows channel conventions

---

## 19. Usage Examples

### Good Example
**Context**: [Where this would appear]
**Copy**:
> [Example of copy that follows all guidelines]

**Why it works**: [Explanation referencing specific guidelines]

### Bad Example
**Context**: [Where this would appear]
**Copy**:
> [Example of copy that violates guidelines]

**What's wrong**: [Explanation of specific violations]

**Corrected version**:
> [Fixed copy]

---

## 20. Document History

| Version | Date | Changes | Author |
|---------|------|---------|--------|
| 1.0 | [Date] | Initial creation | [Name/Claude] |

---

*This specification should be reviewed quarterly and updated as the brand evolves.*

Output Location

Save the completed specification to: {config.directories.contractor_root}/landing-pages/{slug}/spec.md

The {slug} is provided by the caller (e.g., user-supplied project name or the /create-landing-page orchestrator). The {slug} folder under landing-pages/ is shared with the related landing-page skills (create-landing-page, copywrite, css-template) — this skill writes spec.md INTO that existing per-slug folder. If the folder does not yet exist, create it: mkdir -p {config.directories.contractor_root}/landing-pages/{slug}.

---

Interview Approach

Best Practices

1. Ask One Phase at a Time: Don't overwhelm with all questions at once
2. Provide Examples: Use generic examples to clarify expectations
3. Offer Options: When possible, give multiple choice options
4. Confirm Understanding: Summarize answers before moving to next phase
5. Allow Iteration: Let user revise answers before finalizing

Opening Script

Begin with:

"I'll help you create a comprehensive copywriting specification for [Company Name]. This document will define your brand voice, tone, and language guidelines for all communications.

We'll work through 8 phases:

1. Brand Identity
2. Target Audience
3. Voice & Tone
4. Language Guidelines
5. Messaging Hierarchy
6. Proof Points
7. Competitor Differentiation
8. Channel Requirements

Let's start with Brand Identity..."

Closing Script

After generating the document:

"I've created your copywriting specification at [file path].

Recommended Next Steps:

1. Review the document for accuracy
2. Fill in any [TO BE COMPLETED] sections
3. Share with stakeholders for feedback
4. Use /landing-page:create to build pages following this spec

Would you like me to review or refine any section?"

---

Quick Start Mode

If the user provides substantial information upfront (e.g., existing brand guidelines, website content, or detailed brief), skip redundant questions and proceed directly to generation, asking only for clarification on gaps.

To detect quick start eligibility, check if the user provides:

• Company name and positioning
• Target audience description
• At least 3 proof points with context
• Tone/voice preferences

If all four are present, proceed to generation with targeted clarifying questions only.