Grounded Copy
A style gate for marketing copy that enforces concrete claims via a Python linter and Claude Code/Codex session hooks.
HiroHyun · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add HiroHyun/grounded-copy技能说明
grounded-copy
A style gate for marketing and web copy. It enforces one rule: every value proposition states what the subject IS or DOES — a feature, a number, a mechanism. It detects contrast framing in its documented forms, plus hype vocabulary and vague attribution. English gets full per-shape coverage and eight more languages get trigger lists, at the depths the table below sets. A deterministic Python linter backs the rules and blocks the task until the copy complies.
In Claude Code, two hooks carry the same rules into every session, so chat replies follow them alongside landing pages and locale files.
The off switch
The profile controls whether the hooks inject the rules. Set off for source
text that must retain its supplied wording:
/grounded-copy:grounded off
Write the text, then /grounded-copy:grounded chat (or copy) to switch back.
The topics that need it: legal disclaimers, terms of service, regulatory copy,
billing facts, and translations of source text someone supplied. The stored
value survives restarts, so a switch left at off stays there until you set it
back. Outside Claude Code the linter is a command you run, so the same escape
is running it on the files you choose.
Before and after
| Draft | After grounded-copy |
|---|---|
| Vague task-tracker slogan | The tracker links every task to its pull request and posts a status digest to Slack each morning. |
| Hidden-fee slogan | The listed price is the complete price; the invoice adds nothing. |
| Unnamed expert claim | Acme holds 34% of the segment, per Gartner's 2025 market report. |
Same information, carried by specifics. references/patterns.md holds a
rewrite for every shape.
How it works
Paths named below