1---2name: voice-check3description: >-4 Checks any draft (page, post, ad, email) against the company's own voice rules from company-profile.md, a list of5 patterns that make copy read as machine-written, and 3 copy tests, then returns PASS or FAIL with line-level fixes.6 Use it before anything goes out, or as the check step inside any skill that writes copy. Not for checking7 whether claims are true (use claim-check) or for reviewing a whole landing page's structure (use8 landing-page-critic).9license: MIT10compatibility: >-11 Works in Claude, ChatGPT, Codex, Cursor and any agent that reads SKILL.md. Python 3 is optional, for the12 mechanical pass.13metadata:14 author: SHAKEUP15 version: "1.0.0"16 stage: check17 plugin: start-here18 homepage: https://www.shakeuphq.com/skills/voice-check19---20 21# Voice check22 23Finds every line that doesn't sound like the company, says why, and offers the fix.24 25## Purpose26 27- One job: check one draft against the company's voice and return fixes.28- Stage: check. It ends in PASS or FAIL with severities.29- It suggests fixes; it doesn't rewrite the whole draft. A rewrite belongs to the skill that made the draft.30 31## Use when / not32 33| Situation | Use |34| --- | --- |35| A draft is ready and must sound like the company | this skill |36| Another skill reaches its check step on copy | this skill |37| You need to know if a number or claim is backed | `claim-check` |38| You want a structural review of a landing page | `landing-page-critic` |39| You want to test if buyers understand the message | `message-test` |40 41## Inputs42 43| Input | Required | Ways to provide, in order | If missing |44| --- | --- | --- | --- |45| The draft | yes | a file the agent can read; pasted text | ask for it |46| What it is and who reads it | no | the reader's note; infer from the draft | infer, and say what you assumed |47| Voice rules | no | `## Voice` in `company-profile.md`; pasted rules | run on the AI patterns and copy tests only; coverage `partial` |48 49## Profile read50 51`## Voice` (point of view, tone, reading level, words to use, words to avoid, lines that sound right), `## Buyers` (who reads it), `## Claims and proof` (only to avoid flagging an approved claim as vague), and `## Learnings` entries for `voice-check`.52 53No profile: ask for 3 to 5 words that describe the voice and any words the company never uses, in one message. If the reader has none, continue with coverage `partial`.54 55## Steps56 571. **Apply learnings** for this skill (accepted rules override the defaults below).58 592. **Mechanical pass.** Run `scripts/voice_lint.py`:60 61 ```62 python3 scripts/voice_lint.py --draft draft.md --profile company-profile.md63 ```64 65 Without Python, check by hand, line by line: em dashes and en dashes; every phrase under "Words to avoid"; every phrase in `references/ai-patterns.md`; sentences over 30 words; paragraphs over 4 sentences; numbers from two up written as words; consecutive sentences with the same first word. Say which way you ran it.66 673. **Voice pass.** Read the draft as its reader would. For each paragraph, check:68 69 | Check | Flag when |70 | --- | --- |71 | Point of view | It switches between "we", "I" and "you" against the profile |72 | Tone | A line breaks one of the profile's tone words (a "direct" voice that hedges; a "warm" voice that lectures) |73 | Reading level | Jargon the profile's reader wouldn't use, with no explanation |74 | Sounds like the company | It reads unlike the profile's "Lines that sound right" |75 764. **Copy tests.** Apply 3 tests to every claim and headline:77 78 | Test | Fails when |79 | --- | --- |80 | Can I picture it? | Abstract words with no image, number or example ("drive growth", "better outcomes") |81 | Can it be proved wrong? | Nothing in it could be checked ("the best platform") |82 | Could no one else say it? | A competitor could put it on their site unchanged |83 845. **Constructions.** Check the list under "Constructions to watch" in `references/ai-patterns.md`.85 866. **Write the fix.** For each finding: the line, the rule, the problem in a few words, and a rewrite that fixes only that problem in the company's voice. Never fix by adding a claim the profile doesn't support.87 88## Check and verdict89 90Severity: `critical` (a dash; a word to avoid; a point-of-view switch; a line that contradicts the profile), `warning` (an AI pattern; a long sentence or paragraph; a failed copy test on a headline), `suggestion` (number words; repeated openers; a failed copy test in body copy).91 92| Verdict | Condition (first match wins) |93| --- | --- |94| `BLOCKED` | No draft |95| `FAIL` | 1 or more critical findings, or 5 or more warnings |96| `PASS WITH NOTES` | Warnings or suggestions only, fewer than 5 warnings |97| `PASS` | No findings |98 99No named stops. The calling skill decides what to do with a FAIL.100 101## Learn102 103When the reader rejects a finding as wrong for their voice ("we do say 'unlock' in this market"), write a `proposal` learning to remove that rule for this company. When the reader adds a word to avoid, add it to the profile's `### Words to avoid` and record a `fact` learning.104 105## Output106 107```108Verdict: <PASS | PASS WITH NOTES | FAIL | BLOCKED> · Coverage: <complete | partial (no voice rules in profile)> · Mechanical pass: <script | by hand>109Counts: <n> critical, <n> warnings, <n> suggestions110 111| Line | Severity | Rule | Problem | Fix |112(critical first)113 114Strongest line: "<the line that most sounds like the company>"115```116 117Then the handoff block.118 119## Hand off120 121```handoff122skill: voice-check123version: 1.0.0124verdict: FAIL125coverage: complete126for: <draft name>127outputs:128 critical: 2129 warnings: 3130 fixes_ready: true131next: [claim-check]132open: []133```134 135The skill that made the draft reads `critical` and the fix table, applies the fixes and runs this check again (its own loop, at most 2 rounds).136 137## Failure modes138 139| Problem | Do this |140| --- | --- |141| The draft is in another language than the profile | Check dashes, numbers and structure only; say voice rules weren't applied |142| The profile's words to avoid include a word the product name contains | Don't flag the product name |143| A quote from a customer breaks the voice | Quotes are theirs: don't flag inside quotation marks |144| The draft is a table or ad copy with fragments | Fragments are fine in labels, buttons and ad headlines; don't flag them there |145 146## Influenced by147 148- Harry Dry's three copy tests (Marketing Examples): https://www.demandcurve.com/newsletters/growth-newsletter-202149- SHAKEUP's copy lint, which fails a build on dashes, banned words, sentences over 30 words and paragraphs over 4 sentences.