copyskills

Copyskills

Professional copywriting skills for AI agents and humans. 15 skills covering 8 domains, 10 persuasion frameworks, and a built-in anti-slop system that catches AI writing patterns before they ship.

Works as a Claude Code plugin, an MCP server, a CLI tool, or a TypeScript library.

New here? Read USAGE.md for a walkthrough with concrete recipes for each interface. The rest of this README is reference material.

Quick Start

Claude Code Plugin

Install from the marketplace:

claude plugin marketplace add srstomp/copyskills
claude plugin install copyskills@copyskills

Or from inside a Claude Code session:

/plugin marketplace add srstomp/copyskills
/plugin install copyskills@copyskills

Then use slash commands:

/write cold outreach email for SakeBox targeting restaurant owners
/critique ./landing-page-copy.md
/adapt this case study as a LinkedIn post

MCP Server

Add to your MCP client config:

{
  "mcpServers": {
    "copydoc": {
      "command": "npx",
      "args": ["@copydoc/mcp"]
    }
  }
}

The server exposes copywriting knowledge as MCP resources, tools, and prompts. Your agent reads what it needs.

CLI

npm install -g @copydoc/cli
copydoc init
copydoc write "pricing page for a developer tools SaaS"

TypeScript Library

npm install @copydoc/core

import { createLoader, createAssembler, selectFramework, createAntiSlopChecker } from '@copydoc/core';
import { createRequire } from 'module';
import path from 'path';

// Skills are bundled inside @copydoc/core at dist/skills/
const require = createRequire(import.meta.url);
const coreDir = path.dirname(require.resolve('@copydoc/core/package.json'));
const loader = createLoader(path.join(coreDir, 'dist', 'skills'));
const assembler = createAssembler(loader, selectFramework);

const { systemPrompt, userPrompt } = assembler.assemble({
  type: 'cold outreach email',
  goal: 'Book a demo call',
  audience: { who: 'Restaurant owners', pain: 'Bad sake selection' },
  product: { name: 'SakeBox', differentiator: 'Direct from 40+ Japanese breweries' },
});

// Send to any LLM
const copy = await yourLLM.generate(systemPrompt, userPrompt);

// Check for AI patterns
const checker = createAntiSlopChecker(loader);
const { score, issues } = checker.check(copy);

Integrations

Copyskills works with any tool that supports MCP or the SKILL.md standard.

One-Command Setup

npx @copydoc/integrations install

Auto-detects and configures: Cursor, Codex, OpenCode, Hermes, OpenClaw, Pi.

Each tool gets the integration that fits it best:

Tool	What it gets
Cursor	MCP server config + .mdc rule files for each domain skill
Codex	MCP server config + skills directory symlink
OpenCode	MCP server config in .opencode.json
Hermes	MCP server config in ~/.hermes/config.yaml + skills symlink
OpenClaw	MCP server + skills directory in ~/.openclaw/openclaw.json
Pi	Skills symlink + TypeScript extension stub wrapping @copydoc/core

Manual MCP Setup (any MCP client)

Add to your tool's MCP config:

{
  "mcpServers": {
    "copydoc": {
      "command": "npx",
      "args": ["@copydoc/mcp"]
    }
  }
}

Other Commands

npx @copydoc/integrations status      # Check which tools are detected and configured
npx @copydoc/integrations uninstall   # Remove all copydoc integrations
npx @copydoc/integrations install --tool cursor  # Configure only one tool

What's Inside

15 Skills Across 3 Layers

Layer 1: Framework References (the methodology)

Skill	What it provides
persuasion-frameworks	10 frameworks (AIDA, PAS, BAB, FAB, ACCA, PASTOR, QUEST, 4Ps, PPPP, Star-Story-Solution) with decision matrix for when to use each
quality-frameworks	7-dimension scoring rubric, anti-slop detection, Cialdini principles, readability targets
headline-formulas	26 proven headline templates, power words categorized by emotion

Layer 2: Domain Skills (the patterns)

Skill	Covers
marketing-copy	Landing pages, ads (Google/Meta/LinkedIn with char limits), CTAs, value propositions
email-copy	Drip sequences, cold outreach, newsletters, subject lines
ux-copy	Microcopy, error messages, onboarding flows, empty states
editorial-copy	Blog posts, SEO content, thought leadership, whitepapers
brand-copy	Voice profiles, messaging hierarchies, style guides
sales-copy	Case studies, proposals, pitch decks, one-pagers
social-copy	Platform-specific content (X, LinkedIn, Instagram, TikTok), threads, carousels
conversion-copy	A/B test variants, pricing pages, signup flows, checkout copy

Layer 3: Workflow Skills (the orchestration)