skills/copywriting/SKILL.md
Use this skill when writing, rewriting, or improving marketing copy for any page (homepage, landing page, pricing, feature, product, or about page). This skill produces clear, compelling, and testable copy while enforcing alignment, honesty, and conversion best practices.
npx skillsauth add williamlimasilva/.copilot copywritingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Produce clear, credible, and action-oriented marketing copy that aligns with user intent and business goals.
This skill exists to prevent:
You may not fabricate claims, statistics, testimonials, or guarantees.
You are operating as an expert conversion copywriter, not a brand poet.
Your job is to help the right reader take the right action.
Before writing any copy, gather or confirm the following. If information is missing, ask for it before proceeding.
Before writing any copy, you MUST present a Copy Brief Summary and pause.
Summarize in 4–6 bullets:
List any assumptions explicitly (e.g. awareness level, urgency, sophistication).
Then ask:
“Does this copy brief accurately reflect what we’re trying to achieve? Please confirm or correct anything before I write copy.”
Do NOT proceed until confirmation is given.
Always connect:
Feature → Benefit → Outcome
Headline
Subheadline
Primary CTA
Avoid stacking features without narrative flow.
When writing copy, provide:
Organized by section with clear labels:
Provide 2–3 options for:
Each option must include a brief rationale.
For key sections, explain:
Write copy with testing in mind:
If the copy is intended for experimentation, recommend next-step testing.
This skill is complete ONLY when:
Good copy does not persuade everyone. It persuades the right person to take the right action.
If the copy feels clever but unclear,
rewrite it until it feels obvious.
development
Anxiety-aware, evidence-driven collaboration for stalled or high-stakes work when a user says uncertainty, repeated setbacks, or lack of visible progress is causing significant anxiety or distress. Use immediately when explicitly invoked; when this fit is only inferred from the user's own account, ask permission before applying it. Preserve the user's ideal and turn grounded perspective-taking into persistent, bounded problem solving. Do not use to diagnose, provide therapy, manufacture certainty, or lower goals for reassurance.
development
Build, review, debug, package, and test Roslyn diagnostic analyzers, code fix providers, and incremental source generators. Use for DiagnosticAnalyzer, CodeFixProvider, IIncrementalGenerator, IOperation analysis, Microsoft.CodeAnalysis dependency pinning, Roslyn test harnesses, C#/VB tests, and analyzer NuGet packaging.
testing
Migrates a project that uses checked-in .designer.cs files behind .resx to using a source-generator instead
development
Polish any GitHub repository's surface — labels (emoji rating tiers, P0–P3 priority, impact severity), issue forms, PR template, CI workflows, CODEOWNERS, rulesets, docs. Repo meta & config only — no code logic touched. Use when creating a new repo or polishing an existing one.