writing

writing

A technical writing discipline for clear, high-density, anti-slop prose.

Why This Skill Is Needed & Target State

Why this skill is needed: AI agents construct prose by unreflective pattern matching from typical training corpora: inserting defensive preambles ("The following table outlines..."), duplicating perishable constants that can be derived directly from source code, narrating obvious syntax ("// increment i"), and speaking in a monotone, patronizing voice. This dilutes technical substance, tires human readers, and buries essential invariants under ceremonial text.

Target state: Every document conveys the author's exact decisions and technical reasoning on a single pass, transitions immediately from headers into direct payloads, and contains zero perishable or decorative fluff.

Invariant Guidelines

Direct Payload Invariant: Transition directly from domain headers to technical payloads (tables, code blocks, lists, schemas) with zero transitional preambles or affordance narration.
Purpose Before Means: State the objective or problem being solved before prescribing the procedure or mechanism per purpose-before-means.
No Perishable Information: Never duplicate information in markdown that can be derived from code, lockfiles, or type signatures per no-perishable-information.
Single Topic per Document: Separate reference facts (references/), procedural playbooks (usecases/), and conceptual explanations.
One Actionable Decision per Sentence: Pack only one load-bearing directive per sentence so humans and agents do not skim past secondary requirements.

Execution Workflows

ai-context: Drafting high-signal context documents for AI agents (SKILL.md, AGENTS.md, CLAUDE.md).
readme-md: Writing lean, high-conversion project README.md files that respect reader time.

Domain References

purpose-before-means: Ordering rules so readers understand the goal before the implementation.
no-perishable-information: Eliminating drift-prone duplicating of code data.
purpose-and-reason: Pairing every rule with its underlying mechanical rationale.
rhythm: Designing scannable text rhythm and scannability.

Delegated Skills

humanity-and-humanness: Respect human cognitive processing and inferential reading.
poteto-principles: Follow minimize-reader-load and subtract-before-you-add.
anti-slop-engineering: Follow Gate 3 (Taste, Visual Restraint & Clean UI Microcopy) and Gate 0 (Zero Speculative Docs).