yabasha/copywrite-skill

An AI assistant skill that writes high-converting marketing copy for B2B SaaS startups. Covers the full marketing mix — social posts, landing pages, emails, blog/SEO content, launch campaigns, and content calendars — grounded in Schwartz's awareness model and Hopkins' scientific advertising.

Works with any AI code assistant that supports markdown-based instructions — Claude Code, Cursor, Windsurf, Cline, GitHub Copilot, and others.

What It Does

When activated, the skill runs an 8-step copywriting workflow:

1. Intake Interview — Asks 8-12 targeted questions about your product, audience, competitors, growth stage, brand voice, and goals before writing a single word.
2. Competitor Positioning — Analyzes competitor messaging and identifies the gap your copy should own. Names your unique mechanism.
3. Awareness Diagnosis — Classifies your target audience using Schwartz's 5 awareness levels and a market sophistication scale (1-5) to determine headline strategy and CTA intensity.
4. Hooks & Headlines — Produces 2-3 headline/hook variants labeled A, B, C for easy selection or A/B testing. Every headline follows Hopkins' specificity rules.
5. Body Copy — Writes the full draft using long-form (hook → agitate → mechanism → proof → offer → CTA) or short-form (hook → value → proof → CTA) templates depending on format.
6. CTA Writing — Crafts a single, risk-free call-to-action matched to the audience's awareness level.
7. Platform & SEO Optimization — Applies platform-specific constraints (length, format, engagement patterns) and SEO best practices. Suggests visual direction for Instagram, landing pages, and YouTube.
8. Review & Tighten — Runs a checklist to verify hook quality, proof backing, specificity, tone, and platform fit. Cuts 20% of filler.

Supported Content Types

• Social media posts — LinkedIn, X/Twitter, Instagram, TikTok, YouTube
• Landing pages — Hero sections, full-page copy, feature/benefit blocks
• Email campaigns — Cold outreach, nurture sequences, launch announcements
• Blog / SEO content — Long-form guides, keyword-targeted articles, meta descriptions
• Launch campaigns — Pre-launch teasers, launch day sequences, post-launch follow-ups
• Content calendars — Weekly/monthly cadence templates with pillar rotation

Trigger Phrases

The skill activates when you ask your AI assistant to:

• "Write copy", "create a post", "write social media content"
• "Improve marketing text", "plan a launch", "create a content calendar"
• Any request involving startup copywriting, ad copy, landing pages, email campaigns, SEO content, or brand messaging

Frameworks Used

Schwartz's 5 Awareness Levels

Hopkins' Scientific Advertising (7 Principles)

1. Test everything — Always produce 2-3 variants for testing
2. Specificity over generality — Numbers beat adjectives
3. Reason-why copy — Back every claim with "because"
4. Headlines as selectors — Filter for the right reader, not cleverness
5. Service mentality — Teach first, sell second
6. Sampling & risk reversal — Free trials, demos, guarantees
7. Track and measure — UTMs, promo codes, measurable CTAs

Market Sophistication Scale

Repository Structure

copywrite-skill/
├── SKILL.md                                     # Main skill definition (8-step workflow)
├── AGENTS.md                                    # Instructions for all AI assistants
├── CLAUDE.md                                    # Instructions for Claude-based assistants
├── README.md                                    # This file
└── references/                                  # Deep reference material
    ├── intake-questions.md                      # 12-question intake interview template
    ├── schwartz-awareness-levels.md             # Awareness levels + desire channeling
    ├── hopkins-scientific-principles.md          # 7 principles with B2B SaaS examples
    ├── platform-patterns.md                     # Platform rules for 8 channels
    └── campaign-playbooks.md                    # Launch playbook + content calendar

Reference Files

Installation

Claude Code

npx @anthropic-ai/claude-code skill add yabasha/copywrite-skill

Cursor

1. Clone or download this repo
2. Copy SKILL.md and the references/ folder into your project root
3. Add SKILL.md as a project rule: Settings → Rules → Add Rule and point to the file
4. Or paste the contents of SKILL.md into Settings → Rules → User Rules

Windsurf

1. Clone or download this repo
2. Copy SKILL.md and the references/ folder into your project root
3. Create or edit .windsurfrules in your project root and include the contents of SKILL.md
4. Or add it via Settings → AI Rules → Project Rules

Cline

1. Clone or download this repo
2. Copy SKILL.md and the references/ folder into your project root
3. Add the contents of SKILL.md to your custom instructions in Settings → Custom Instructions

GitHub Copilot

1. Clone or download this repo
2. Copy SKILL.md and the references/ folder into your project root
3. Create .github/copilot-instructions.md and include the contents of SKILL.md

Any Other AI Assistant

The skill is a standard markdown file with YAML frontmatter. Any AI assistant that reads markdown instructions can use it:

1. Clone or download this repo
2. Copy SKILL.md and the references/ folder into your project
3. Point your assistant's custom instructions or system prompt to SKILL.md

git clone https://github.com/yabasha/copywrite-skill.git

Usage Examples

> Write a LinkedIn post for my B2B SaaS product

> Create a launch campaign for our new developer tool

> Write a landing page for our project management platform

> Plan a content calendar for our pre-launch phase

> Improve this email subject line: "Check out our new features"

> Write an Instagram carousel about reducing engineering burnout

The skill starts with the intake interview, then walks through each step to deliver platform-optimized, framework-backed copy with multiple variants.

License

MIT