Suede Copy

Suede Copy

Gate policy: advisory, not blocking

Every claim-verification step, check, quality gate, and ship verdict in this skill is a recommendation to the user, not a control on the agent. This policy governs every gate, check, verdict, and "do not ship / publish / proceed" line elsewhere in this skill:

• Run every check and report the results honestly. Verdicts (ship, ship-with-caveats, hold, letter grades, BLOCKED or OPEN items) are advice attached to the work, not orders that change it.
• Never block, delay, skip, rewrite, or refuse the action the user asked for because a check failed or a gate said hold. Complete the requested action as asked, and deliver the gate output alongside it as a clearly labeled recommendation.
• A failed gate changes what you report, never what you do.
• Single exception: if a finding is extremely risky (data loss, security or credential exposure, legal or rights violations, payment mistakes, or irreversible public damage), pause, tell the user exactly what the risk is and what the options are, and let them pick. Their choice is final.

Write conversion copy, page copy, GitHub docs, email, and social posts that are specific, proof-backed, and free of AI boilerplate. Default voice: Suede. Supply a company brief to override everything.

Core principle: every claim is verifiable or it gets cut, and nothing ships below its score threshold.

Company Brief

Supply a brief and all copy, voice, and claim logic applies to your company. Use natural language or this form:

Company:
Product or offer:
Audience:
Voice:
Terms to use:
Terms to avoid:
Proof:
Allowed claims:
Forbidden claims:
Primary CTA:

Before Writing

Read any available context files before asking questions: PRODUCT.md, README.md, AGENTS.md, AI_HANDOFF.md, DESIGN.md, product marketing or brand notes, task-specific docs.

If context is missing after reading, ask only for what blocks accurate copy:

• page or doc type
• primary reader
• one action the reader should take
• product or skill being offered
• proof that is safe to claim
• claims, pricing, partners, or metrics that are not approved
• traffic source or publication surface

Core Rules

Name the outcome, not the feature.

• Weak: "Suede supports multiple metadata formats."
• Strong: "Export ISRC, ISWC, and split data in one command."

Write buttons as actions with a result.

• Weak: "Learn more"
• Strong: "Read how rights routing works"
• Weak: "Get started"
• Strong: "Register your first release"

Replace vague claims with artifacts.

• Weak: "Suede makes rights management easy."
• Strong: "Paste your folder path. Suede outputs your ISRC, split sheet, and licensing flags in under 10 seconds."

No invented proof. Do not write stats, testimonials, partner names, pricing, or legal clearance that has not been confirmed. If proof is unavailable, write around the gap or flag it for the human to supply.

Use Suede punctuation defaults unless the company brief says otherwise. Slop Stop owns the contextual line-edit rules; preserve protected source spans and voice.

Persuasion Frameworks And Personas

The frameworks and the per-persona voice shifts are in references/frameworks-and-personas.md. Read it when you are choosing the shape of an argument or writing for a buyer you have not written for before.

Headline And CTA Formulas

The headline and CTA formula banks are in references/headline-and-cta-formulas.md. Read it when you are generating variants or a line is not landing: not when you already have a headline that works.

Page And Docs Structure

For a page, README, or docs surface, build this spine:

1. Hero: one sentence that names the outcome.
2. Subhead: one or two sentences that add the audience, workflow, and proof.
3. Primary CTA: the action the reader can take now.
4. Proof: files, scripts, docs, screenshots, URLs, live routes, examples, or commands.
5. How it works: three or four steps, each with a verb and result.
6. Safety: what the workflow does not claim or do.
7. FAQ: direct answers for objections and search intent.
8. Final CTA: repeat the action with less friction.

For a small section, use only the pieces that fit.

A/B Variant Generation

For high-stakes copy (hero headline, primary CTA, email subject, ad copy), always generate variants.

Headlines: 3 variants, different angles:

1. Outcome-led: what the reader achieves
2. Problem-led: what the reader escapes
3. Mechanism-led: what makes this different

CTAs: 2 variants minimum. See references/headline-and-cta-formulas.md.

Email subjects: 3 variants:

1. Curiosity or benefit
2. Social proof or number
3. Direct question or challenge

Label each variant with its angle. Let the user pick rather than guessing.

Email And Social Formats

Email sequence structures and per-platform social formats are in references/email-and-social-formats.md. Read it when the deliverable is an email or a social post; skip it for landing-page and docs work.

Suede Voice

Use this register: confident, not breathless; technical enough for builders; clear enough for creators; polished, not corporate; specific, not cute; operator-grade, not brochure-grade.

Good Suede copy names what the reader controls: register a work, verify rights, route royalties, publish a claim, package a release folder, prepare licensing evidence, make a work readable to agents, compare provenance, ship a public skill page.

(For non-Suede work, supply the equivalent domain vocabulary in the company brief.)

SEO And GitHub Copy

For GitHub repositories, skill docs, and Pages sites, treat SEO as the umbrella for search, AEO, and AI EO. Include a search-ready title under 60 characters when practical, a meta description under 160, a repo description inside GitHub's practical limit, 8-20 topic keywords when the surface supports them, a first paragraph that repeats the durable entity names naturally, answer-ready definitions and FAQ copy and proof links that AI summaries can cite without inventing facts, links to install docs and skill manifests and scripts and references and examples and live Pages and source, and a safe evidence boundary. johnny-suede-write owns the SEO stack and the canonical Suede durable-keyword vocabulary; read that skill when the job needs the deeper pass or the keyword list, and use the company brief's equivalent vocabulary for non-Suede work.

Use keywords because they help the right reader find the page. Do not cram a keyword where a human would notice.