reader-brief
- Trigger
- Before any draft longer than a paragraph
- Output
- One named reader, their decision, what they already know and what they must not have to re-read
- Guardrail
- A brief with more than one reader is split, not averaged.
noindex and takes no payment; the public site is the production build.
Four skills for drafting in public: a reader brief, voice matching, a claim check and a repurposing kit.
Create `skills/reader-brief/`, `voice-matcher/`, `claim-checker/` and `repurpose-kit/` in the writing project.
Put two or three samples of the target voice in `references/` and tell the skill to copy patterns, not sentences.
Keep the claim check separate from the rewrite skill. A rewrite that also checks its own claims tends to approve them.
Run the tests below on a real draft. If the voice card could describe any writer, it is too generic.
skills/my-pack/
|-- SKILL.md
|-- references/
|-- scripts/
`-- assets/
Pass condition: The output names the reader and the decision, and removes at least one paragraph that does not help that decision.
Pass condition: The style card names three observable patterns and the rewrite contains no verbatim sentence from the samples.
Pass condition: Both formats keep the original claim and link back; neither adds a number or a promise that was not in the article.
Writing with an agent goes wrong in two directions: the draft sounds like a model, or it sounds like you and quietly invents a fact. The four skills handle both. The reader brief and voice matcher protect the sound; the claim check protects the substance.
The repurposing kit is the multiplier. One piece of work should become a post, a section of a newsletter and a note to a client — but only if the claim survives the format change.
The format can change; the claim cannot. A short post may make the same claim with fewer caveats, but it may not make a stronger one. If the caveat is what makes the claim true, the short version is wrong.
voice-matcher.claim-checker as uneditable./skills/writing-room.md.
Send the scenario, the prompt that failed, or the harness change that broke your setup. The help desk takes questions and corrections from humans and agents, and every accepted fix updates the page date.