yabasha/copywrite-skill
This project provides a structured AI copywriting skill designed specifically for B2B SaaS startups. It serves as a comprehensive instructional framework that guides developers and marketers through every stage of the content creation process—from initial intake interviews to final platform-specific optimization. It is intended for anyone looking to move beyond generic AI output by anchoring their marketing copy in established, high-conversion frameworks.
The skill is built upon two pillars: Eugene Schwartz’s five levels of consumer awareness and Claude Hopkins’ principles of scientific advertising. By organizing the workflow into an eight-step process, it forces the AI to execute a rigorous sequence, including competitor positioning, audience diagnosis, and a mandatory "review and tighten" phase that aims to reduce filler and improve clarity. It is technology-agnostic, functioning as a markdown-based rule set that can be integrated into popular agents like Claude Code, Cursor, Windsurf, Cline, and GitHub Copilot.
This tool is worth a look for developers or founders who want to standardize their marketing output without manually rewriting prompts. By shifting from conversational, ad-hoc AI prompts to a dedicated, reference-based skill, it ensures that every asset—be it a LinkedIn post, landing page, or email campaign—maintains consistent brand voice and strategic intent.
- Stars
- 3
- Forks
- 0
- Language
- —
- Updated
- 3mo ago
§ Readme
Edit on GitHub ↗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:
- Intake Interview — Asks 8-12 targeted questions about your product, audience, competitors, growth stage, brand voice, and goals before writing a single word.
- Competitor Positioning — Analyzes competitor messaging and identifies the gap your copy should own. Names your unique mechanism.
- 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.
- 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.
- 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.
- CTA Writing — Crafts a single, risk-free call-to-action matched to the audience's awareness level.
- Platform & SEO Optimization — Applies platform-specific constraints (length, format, engagement patterns) and SEO best practices. Suggests visual direction for Instagram, landing pages, and YouTube.
- 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
| Level | Audience State | Headline Approach | CTA Style |
|---|---|---|---|
| Unaware | Doesn't know the problem | Pattern interrupt, surprising stat | Soft / none |
| Problem-Aware | Feels the pain | Agitate and name the problem | Educational |
| Solution-Aware | Knows solutions exist | Introduce unique mechanism | Low commitment |
| Product-Aware | Knows your product | Stack proof, handle objections | Medium |
| Most Aware | Trusts you | Lead with the offer | Direct |
Hopkins' Scientific Advertising (7 Principles)
- Test everything — Always produce 2-3 variants for testing
- Specificity over generality — Numbers beat adjectives
- Reason-why copy — Back every claim with "because"
- Headlines as selectors — Filter for the right reader, not cleverness
- Service mentality — Teach first, sell second
- Sampling & risk reversal — Free trials, demos, guarantees
- Track and measure — UTMs, promo codes, measurable CTAs
Market Sophistication Scale
| Stage | Market State | Copy Strategy |
|---|---|---|
| 1 | First mover | Simple, direct claim |
| 2 | Competitors emerging | Amplify claim (bigger, faster) |
| 3 | Claims saturated | Introduce unique mechanism |
| 4 | Mechanisms copied | Stack proof and specifics |
| 5 | Market skeptical | Lead with identity and story |
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
| File | Purpose |
|---|---|
intake-questions.md | 12 structured questions covering product, audience, competitors, stage, voice, platform, proof, and goals |
schwartz-awareness-levels.md | Detailed playbook for each awareness level with B2B SaaS strategies, headline templates, and desire channeling techniques |
hopkins-scientific-principles.md | Seven advertising principles with weak vs. strong copy examples for SaaS |
platform-patterns.md | Format rules, hook strategies, CTA patterns, and visual direction for LinkedIn, X, Instagram, YouTube, TikTok, Email, Blog/SEO, and Landing Pages |
campaign-playbooks.md | Phase-by-phase launch campaign (pre-launch → launch day → post-launch) and weekly content calendar with pillar rotation |
Installation
Claude Code
npx @anthropic-ai/claude-code skill add yabasha/copywrite-skill
Cursor
- Clone or download this repo
- Copy
SKILL.mdand thereferences/folder into your project root - Add
SKILL.mdas a project rule: Settings → Rules → Add Rule and point to the file - Or paste the contents of
SKILL.mdinto Settings → Rules → User Rules
Windsurf
- Clone or download this repo
- Copy
SKILL.mdand thereferences/folder into your project root - Create or edit
.windsurfrulesin your project root and include the contents ofSKILL.md - Or add it via Settings → AI Rules → Project Rules
Cline
- Clone or download this repo
- Copy
SKILL.mdand thereferences/folder into your project root - Add the contents of
SKILL.mdto your custom instructions in Settings → Custom Instructions
GitHub Copilot
- Clone or download this repo
- Copy
SKILL.mdand thereferences/folder into your project root - Create
.github/copilot-instructions.mdand include the contents ofSKILL.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:
- Clone or download this repo
- Copy
SKILL.mdand thereferences/folder into your project - 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
§ Cite this project
For papers, blog posts, & AI referencesBashar Ayyash. (2026). yabasha/copywrite-skill [Computer software]. https://yabasha.dev/open-source/copywrite-skill