Brief — Skill de Marketing Full-Stack para Claude
inerrata/brief
Marketing full-stack: copy, brand, SEO, CRO, campaigns — sem marketing vazio
Ver no GitHubSkill especializada em marketing que drafta copy, audita páginas e planeja campanhas com guardrails. Usa disclosure progressivo para carregar 9 módulos de referência conforme necessário, evitando bloat de contexto. Testada contra 26 avaliações com +18pp de melhoria sobre baseline.
Instalação
npx convez-ai inerrata/brief1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Draftar headlines e copy para landing pages e homepages
- Auditar páginas de marketing e identificar gaps de mensagem
- Planejar campanhas de marketing com estratégia e CRO
- Pesquisa de mercado e segmentação de audiência
- Otimização de SEO e lifecycle marketing
Veredito

Skill bem fundamentada, com avaliações rigorosas (26 evals, +18pp vs baseline). Abordagem de progressive disclosure é inteligente para evitar context bloat. Recomendado para quem precisa de marketing técnico com guardrails e sem bullshit.
README
A tradução para o português deste README ainda está na fila.
Unlike single-file marketing prompts, this skill uses progressive disclosure: a lightweight routing layer (SKILL.md) that loads 9 purpose-built reference modules only when relevant. The depth of nine specialist playbooks, none of the context bloat. Works with Claude Code, Claude.ai, the Claude API, Cursor, Codex CLI, Gemini CLI, and anything that reads the open SKILL.md format.
Table of contents
- Before / After
- Benchmarks
- Install
- What you get
- Use cases
- How it works
- The brief-first philosophy
- The universal quality bar
- Evaluation
- Design principles
- FAQ
- Roadmap
- Contributing
- License
Before / After
Prompt: "I need words for the top of my homepage — it's a tool that schedules social posts."
| ❌ Without the skill | ✅ With the skill |
|---|---|
| "Welcome to the future of social media management! Our powerful, all-in-one platform helps you streamline your workflow and supercharge your presence." | Assuming small businesses / solo creators managing their own social presence — adjust if you mean agencies.Headline: Schedule a week of social posts in 20 minutes.Subhead: Plan, schedule, and publish across every channel — so you show up consistently without living on your phone.CTA: Start scheduling free |
| Vague adjectives, no audience, no CTA, says nothing only-this-product could say. | Outcome-led headline, real subhead + CTA, one stated assumption, sharpening questions offered after the draft. |
That difference is measurable — see below.
Benchmarks
Each of 26 eval prompts was run with the skill and without it (baseline), then graded against per-prompt assertions. Full method, per-eval table, and raw outputs in benchmarks/ and evals/.
| Metric | With skill | Baseline | Delta | Runs |
|---|---|---|---|---|
| Iteration-3 (projected, targeted re-bench) | 98.9% | 80.7% | +18.2 pp | 1× |
| Iteration-2 (3× avg) | 86.4% | 80.7% | +5.7 pp | 3× |
| Iteration-1 (1× directional) | 82.7% | 62.3% | +20.4 pp | 1× |
Iteration-3 edited the skill to fix the five weak spots iteration-2 surfaced (over-gating on calendars/ICPs/launches, withholding on the honesty probe, missing measurement caveats). The six affected evals went from a 0.20–0.86 spread to 1.00 each. The 98.9% is projected — the iteration-2 table with those evals substituted (1× re-run). Full fixes + caveats in benchmarks/benchmark-iteration-3.md.
Held-out v2 set — 24 brand-new prompts
To check the iteration-3 skill against cases it was never tuned on, a separate AI generated 24 fresh evals (see evals/NEW-EVALS-PROMPT.md) — including traps in both directions of the ask-vs-deliver boundary.
| Held-out v2 | Result |
|---|---|
| Assertions passed | 122 / 122 |
| Evals at 1.00 | 24 / 24 |
Both gate directions held: strategy statements (positioning, value prop, messaging hierarchy) asked first; working documents (ICP, content calendar) delivered on stated assumptions. Negative controls didn't fire. Method + honest caveats (1× run, self-graded) in benchmarks/benchmark-v2-evalset.md.
Where it moves the needle most (iteration-2):
| Eval | With | Base | Δ | Why |
|---|---|---|---|---|
| positioning statement (Gate A) | 1.00 | 0.00 | +1.00 | asks the load-bearing questions instead of guessing |
| implicit trigger (#22) | 1.00 | 0.50 | +0.50 | fires correctly with no marketing keywords |
| BF subject lines | 0.92 | 0.50 | +0.42 | angle labels, preview text, length-checked |
| homepage hero | 1.00 | 0.75 | +0.25 | outcome-led copy on a stated assumption |
| competitor analysis | 1.00 | 0.67 | +0.33 | ends in white-space gap, not just description |
Negative controls ("name my cat", "explain DNS", "thank-you note to grandma", plus v2's resume bullet, TCP/UDP, and a eulogy) correctly did not trigger. The iteration-2 weak spots are now fixed and re-benchmarked — see benchmarks/README.md.
📊 Browse every output and grade: open evals/review.html in a browser.
Install
Quick start (Claude Code)
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/inerrata/marketing-tool/main/install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/inerrata/marketing-tool/main/install.ps1 | iex
### Claude Code (project-specific)
```bash
cp -r marketing-tool/_unpacked/marketing .claude/skills/marketing
Claude.ai
Download marketing.skill and upload it under Settings → Capabilities → Skills (Pro/Max/Team/Enterprise). The file is just a zip of _unpacked/marketing/ — repackage it yourself with any zip tool.
What you get
| Module | Covers |
|---|---|
| Copywriting | Ads, emails, landing/sales pages, homepages, CTAs, taglines, social posts, microcopy — PAS / AIDA / BAB / 4Ps / FAB, 10-point editing checklist |
| Brand & messaging | Positioning, value propositions, messaging hierarchy, brand voice & tone, naming, message testing |
| Content strategy | Content pillars, funnel mapping, calendars, content ratios, repurposing, distribution, audits |
| Campaigns & GTM | Campaign briefs, concept development, phased launches, go-to-market plans, asset checklists |
| Research | Personas, ICPs, segmentation, jobs-to-be-done, competitor gap analysis, voice-of-customer |
| SEO | Search intent, keyword strategy, content briefs, on-page optimization, E-E-A-T |
| Email & lifecycle | Welcome / nurture / sales / onboarding / win-back / abandoned-cart sequences, newsletters, deliverability |
| CRO | Conversion audits, the conversion equation, A/B testing methodology, high-impact fixes |
| Measurement | Metrics by goal, AARRR funnel, CAC / LTV / ROAS formulas, attribution, reporting |
Use cases
Concrete scenarios, the prompt that triggers them, and what you get back.
Launching something
| You want to… | Say… | You get |
|---|---|---|
| Launch a product with no plan | "Help me launch my habit-tracking app." | Scoping questions, then a one-page brief + phased pre-/launch/post timeline + asset checklist |
| First customers from zero | "Nobody knows my store exists. How do I get my first 100 customers?" | A focused acquisition plan — one channel/motion to start, matched to audience |
| GTM as a solo founder | "Launching a paid Notion-template business next month, no audience — what's my plan?" | A sequenced GTM plan (research + channel + content + email + launch), one motion first |
Writing copy that converts
| You want to… | Say… | You get |
|---|---|---|
| Cold outreach email | "Cold email to SaaS founders for my churn-reduction tool." | Subject + preview, relevance-first opening, one idea, one low-friction CTA |
| Homepage hero | "Words for the top of my homepage — a tool that schedules social posts." | Headline + subhead + CTA options, outcome-led, on a stated assumption |
| Subject-line options | "3 Black Friday subject lines for a coffee subscription." | Three distinct angles (curiosity / benefit / urgency), labeled, length-checked |
| Avoid fake proof | "Write a landing page with impressive testimonials and stats." | The page, with marked placeholders + why fabricating proof breaks trust and law |
Strategy & positioning
| You want to… | Say… | You get |
|---|---|---|
| Nail positioning | "Positioning statement for a PM tool aimed at agencies." | 2–3 sharp questions first, then a defensible statement — not a guess |
| Define brand voice | "Help me define my brand voice." | Short discovery, then a voice profile with do/don't dimensions and tone-by-moment |
| Value proposition | "Meal-prep for busy parents, ready in 5 min, no ultra-processed — write my value prop." | An outcome-led value prop only your brand could say |
Content, SEO, lifecycle, measurement
| You want to… | Say… | You get |
|---|---|---|
| Content calendar | "Content calendar for a B2B fintech startup." | 3–5 pillars, funnel mapping, value-heavy mix, calendar w/ pillar/stage/format/title/CTA |
| SEO brief | "SEO brief targeting 'best crm for nonprofits'." | Intent → format, title/meta, outline, People-Also-Ask, E-E-A-T, with a real-data flag |
| Welcome sequence | "Design a welcome sequence for my newsletter." | 3–5 email flow with timing + one CTA each |
| Win-back | "Win-back sequence for users inactive 60 days." | Re-engagement flow + suppression of non-responders to protect deliverability |
| Audit a page | "My pricing page isn't converting — audit it." | Asks for the real page first, then a structured audit + prioritized fixes |
| What to measure | "What should I track for a new paid ads channel?" | Primary metric (CAC/ROAS), leading indicators, formulas, vanity-metric + attribution caveats |
| Unit economics | "Is a $400 CAC good if customers pay $50/mo for ~18 months?" | LTV + LTV:CAC math shown, read against ~3:1, with the caveats |
How it works
marketing/
├── SKILL.md ← routing layer, brief-first gates, quality bar
└── references/
├── copywriting.md ├── research.md ├── email-lifecycle.md
├── brand-messaging.md ├── seo.md ├── cro.md
├── content-strategy.md ├── campaigns.md └── measurement.md
At session start, only the SKILL.md description (~100 tokens) is in context. When a marketing task is detected, the full SKILL.md loads and routes to the relevant module(s); unused modules never load. Multi-area requests pull several and synthesize.
Two hard gates enforce quality:
- Gate A — Strategy foundations (positioning, value prop, voice, GTM): asks 2–3 sharp questions before writing. These are load-bearing — everything downstream inherits their flaws.
- Gate B — Audits / "improve my X": requests the actual asset first. It won't invent a page's contents and critique its own invention.
Everything else scales to stakes: big ambiguous strategy work gets a couple of questions first; a concrete copy deliverable (a hero, an ad, subject lines) is drafted immediately on a stated assumption, with sharpening questions after — a draft you can react to beats an interrogation.
The brief-first philosophy
Before producing anything, the skill establishes (or explicitly infers and flags) five things:
- Audience — who specifically, and what do they believe now?
- Goal — the one action this should drive.
- Offer — what's marketed, and the single most important thing about it.
- Proof — the evidence behind the claims.
- Constraint — channel, length, tone, brand rules.
Audience and goal are never silently guessed. When the skill assumes, it says so ("Assuming [X]; adjust if wrong") so you can correct it in one line.
The universal quality bar
Checked against every deliverable before it ships: specificity (numbers, not adjectives) · reader-first · one message per piece · proof over claims · clean mechanics (active voice, cut filler) · earn the next line · honesty (no fabricated stats, testimonials, or credentials).
Evaluation
The skill ships with its own test suite in evals/: 26 prompts (evals.json) plus a 24-prompt held-out v2 set (evals-v2.json, AI-generated) covering every module, phrasing variations, both gate checks, deliver-first traps, multi-module synthesis, an implicit trigger, an honesty probe, and negative controls (prompts that should not trigger it).
The harness runs each prompt with and without the skill, records whether the skill chose to trigger (available, not forced), and grades every output against per-prompt assertions — measuring triggering accuracy and output quality at once.
- 📊 Aggregate + per-eval table →
benchmarks/README.md - 🧪 Eval set + harness + raw results →
evals/ - 🖥️ Click-through viewer →
evals/review.html
Reproduce it in Claude Code with the skill-creator skill:
Use the skill-creator skill to run a full eval pass on ./_unpacked/marketing using ./evals/evals.json.
Run with-skill and baseline for each prompt, grade against expected_output, and generate the benchmark viewer.
Design principles
- Specificity over cleverness — numbers and outcomes, not vague adjectives
- Reader-first — leads with the audience's problem, not the product's features
- Brief before output — never silently guesses on audience or goal
- Proof over claims — every significant claim needs support
- One message per piece — every asset has exactly one job
- Draft-first for copy, questions-first for strategy — match friction to stakes
- Honest by default — never fabricates proof; surfaces advertising/email-compliance considerations
FAQ
Does it need an API key or dependencies? No — plain Markdown in the SKILL.md format. Nothing to run or install.
Why does it sometimes ask questions instead of answering? For strategy foundations and audits, a confident guess is worse than a question. For ordinary copy, it drafts first and asks after.
Will it invent testimonials or stats if I ask? No. It uses marked placeholders and explains why fabricated proof breaks trust and advertising law.
Does it work outside Claude? Yes — any tool that reads SKILL.md (Cursor, Codex CLI, Gemini CLI, …).
How is this different from "be a marketer"? Frameworks, gates, and a quality bar make output consistent and grounded — and the eval suite lets you verify it instead of trusting vibes.
Can I customize it? Yes — edit the reference modules for your brand rules/voice, and add eval prompts to keep it honest.
Roadmap
- More reference modules (paid-media buying, partnerships/influencer, PR & comms, localization)
- A brand-profile file the skill reads so output inherits your voice automatically
- ✅
Multi-run (3×) eval pass with variance reporting(iteration-2) and ✅fix the tracked weak spots(iteration-3, re-benchmarked) - Independent grading: run the held-out v2 set on a different model with a third-model grader to remove self-grading bias
- 3× multi-run pass on the v2 set; merge it into the standing regression suite
- More worked before/after examples
Contributing
Star if useful.
PRs and issues welcome.
- Keep
SKILL.mdlean — it's always loaded; depth goes inreferences/ - Add eval prompts in
evals/evals.jsonfor any new module (happy path + a phrasing variation + gates) - Run the eval set before and after your change so triggering and quality don't regress
License
MIT — see LICENSE.