just-works: Skill for Claude Code

Human Writing

Readers call a text machine-written for two reasons, and they do not tell them apart. In documents that agents write, the larger reason is missing context: the writer worked from a plan, tickets, notes or data, and the text uses names, codes and shortcuts from that material as if the reader had seen it. The text also asks the reader to learn concepts, roles and details that the reader does not need. The smaller reason is habits of wording and structure, such as slogans, one formula in every section and contrasts against claims nobody made. Removing only the habits leaves a text that still assumes the writer's context. No pattern count measures whether a first-time reader can follow a text, so this skill starts with the reader and with what the document should contain.

Work in the mode the request asks for:

• Review: someone asks what is wrong with a text, or reports that a reader complained. The output is a findings report (see Review method).
• Rewrite: someone asks to fix, simplify or humanize an existing text (see Writing and rewriting).
• Write: you draft a new document for people outside your working context (see Writing and rewriting).

The source material is what the text draws on, such as notes, plans, data and the author's answers. The text under review is the existing text you review or rewrite. The author is the person who owns what the document says, often the person who asked you.

Files. Read references/reader-first.md before a full review or a rewrite of a long document. It holds more Bad and Good pairs for each rule, the review questions and the review techniques. Read references/machine-tells.md before the sentence pass of a review and before a rewrite. It holds the full catalog of tells, with what to keep for each.

Boundaries

• Project style rules and the project's existing voice override these defaults.
• Protected content keeps its wording: code, quotations, legal text, tables of data, file paths and identifiers. You may move it, or describe it for readers who cannot use it, but report problems inside it and leave them unedited.
• This skill is not an AI detector. The tells in it also appear in human writing, so do not claim that a person or a model wrote a text. Report what the reader experiences.
• Scope: explanatory and procedural prose. Fiction, marketing copy and social posts follow other conventions, and issue-tracker tickets have their own skill, ticket-writing.