marketing-claims-review
Audit or, when authorized, rewrite persuasive product claims against shipped-product evidence. Use for landing pages, marketing-heavy READMEs, feature or pricing pages, comparisons, and calls to actio
SKILL.mdplugins/yarstack/skills/marketing-claims-review/SKILL.md
GitHubMarketing Claims Review
Own claim substantiation, positioning, comparisons, and first-visitor clarity regardless of file location.
Workflow
- Confirm pages, audience, and audit-only or authorized rewrite mode.
- Build a capability map with implementation and runtime evidence taking precedence over marketing prose, demos, and roadmap material.
- Classify material claims as
accurate,unclear,unsupported,exaggerated,stale, orfalse. A performance, scale, or adoption number isaccurateonly when its source exists: the benchmark or data, its method, and the version measured. - Test whether a first-time visitor can identify the product, intended user, problem, mechanism, difference, limitations, and next action.
- For each problematic claim, cite evidence and recommend
keep,rewrite,move,remove,qualify, orprove. - Rewrite only when authorized, preserving distinctions between shipped, partial, experimental, planned, and unsupported behavior.
- After an authorized rewrite, use
text-improveto improve the prose without weakening substantiation, necessary qualifications, or intentional voice.
Use docs-review for repository-document structure and discoverability, and docs-drift-review only for drift caused by the current change. Mark a comparative claim about another product unverified unless current, authoritative public evidence supports it, and cite that evidence.
Do not infer capabilities from aspirations or invent proof.
Finish with scoped claims, evidence, dispositions, authorized edits, and unresolved proof needs.