llm-writing

What the source does

• FilesystemNone observedNo reads or writes in the source
• NetworkNone observedNo outbound calls in the source
• ShellNone observedNo commands run in the source
• DependenciesPinnedNothing floats
• SecretsNone foundNo keys in source

Five audit layers

Gates applied: no behavioural pass.

Audit 0.4.1 · source sha 91a3e8e990b9 · 26 Oct 2026Report an issue or request a re-scan

• Publisherhaowjy GitHub userOwner of the repository this skill is read from
• Source folderhaowjy/creative-writing-skills/cw/skills/llm-writingThe exact folder we audited
• LicenceApache-2.0As the repository states it
• Commit pinned for this verdict91a3e8e990b9A new audit runs when the source changes
• Repository statusNot archivedPushed today
• Sandboxed runNot runSkills are read, not executed; layer L4 is skipped

Its description: Load before writing or revising human-facing text. Choose words deliberately, ground the piece in the reader's context, and remove default LLM phrasing before the final draft.

---
name: llm-writing
description: Load before writing or revising human-facing text. Choose words deliberately, ground the piece in the reader's context, and remove default LLM phrasing before the final draft.
---

# LLM Writing

Load `/intent-modeling` if it isn't already loaded.
Load `/information-hierarchy` when the piece grows beyond a short answer.

## Write Intentionally

Before producing a written artifact:

1. **Scope.** Who reads this, and when? Text that outlives the conversation (files, prompts, docs, commit messages, PRs) is read by someone without it: a cold agent, a teammate, or the person who asked, after they've forgotten it. Write for that reader. What do they know when they start, and what should they know when they finish? What do they not need to know? Before writing, break the piece into beats: each beat is one move in the reader's journey, carrying one idea, purpose, or turn.
2. **Ground.** Check any relevant source material, references, or notes before writing, and make sure they align.
3. **Draft.** Write the whole piece where you can revise it before it reaches its reader: the file itself when you're writing one, otherwise a scratch file or your working notes. Text sent straight into a chat, a PR, or a commit gets no revision pass.
4. **Revise.** Start with the whole artifact, then move inward: structure, beats, paragraphs, sentences, words. At each scale, ask what the writing is doing: is it correct, does it follow from what came before, and does the reader need it? Delete or rewrite anything that does not serve a purpose or give the reader something they need to understand or know. Move back and forth between scales: after a local change, zoom back out through the surrounding beat, larger structure, and full artifact; the change should still connect, and the rhythm should still vary. Check disclosure tiers: the answer still leads, depth hasn't crept forward, sources sit at the end.

## What to Delete

- Writing to fill a section because it exists. Delete it or merge its content where it belongs.
- Labeling concepts without explaining how they work. Explain the mechanism or cut the label.
- Stating conclusions without evidence. Show the evidence or drop the claim.
- Hiding uncertainty behind confident language. Say what you don't know.
- Softening every claim with qualifiers ("it's worth noting," "it's important to consider"). Say it or don't.
- Conditions on an instruction ("only when," "unless," "if needed," "when you think it's ready"). Most are hedges. State the instruction flat; keep a condition only when the instruction is wrong on the other side.
- Repeating what you already said in different words, or summarizing the body as a conclusion ("In summary," "Overall"). Delete it.
- Connecting ideas with transition words instead of meaning ("Moreover," "Furthermore," "Additionally"). If the relationship isn't clear without the word, restructure.
- Pairing clauses where one half already carries the meaning ("It's not X, it's Y"). Keep the half that carries it.
- Conversational bleed: writing as if replying inside the conversation that produced the text. Terms coined there, the incident behind a rule, "the old version," "as discussed," answers to questions the reader never asked. The reader wasn't there. Write for the reader, with reasons they can check without the conversation.

Excerpt, first 3,366 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.

git clone https://github.com/haowjy/creative-writing-skills
git -C creative-writing-skills checkout 91a3e8e990b9

Works in

1. 2026-10-26
   ✓SAFE B 89 / 100

   first audit · source 91a3e8e990b9

Questions about llm-writing

• github.com/haowjy/creative-writing-skills/tree/main/cw/skills/ll — the audited source at commit 91a3e8e990b9 and every finding aboveObserved · 26 Oct 2026

Spotted something wrong? Report a correction · Methodology