← ClaudeAtlas

module-writing-floorlisted

Module — loaded by name from an m-skills architect, not an entry point. The floor for any document a project ships: prerequisites first, runnable examples, real identifiers, task-shaped headings, resolving links, no time estimates — plus the refuse list of documentation slop.
matis-dev/m-skills · ★ 0 · Code & Development · score 75
Install: claude install-skill matis-dev/m-skills
# Module: The Writing Floor **Loaded by:** `documentation-architect` · `product-architect` · `search-optimization-architect` · `rolling-history` · `deployment-architect` · `marketing-architect`. Read it whenever a run emits a document a reader will follow; do not restate its content in a skill file. Checks on the **rendered document**, not on intentions. Run them together in one batched verification round. --- ## 1. The Floor - **Time to first success** — prerequisites (runtime versions, accounts, keys, OS constraints) appear **before** the first install command, not in a section below it. The path from landing on the page to something working is the shortest thing on the page. - **Every code block is runnable as written** — language-tagged, copy-pasteable, no invisible prerequisite, no `$` prompt prefix mixed into copyable lines, no placeholder where a real value from this repo exists. Multi-line commands survive a copy. If output matters, show the real output. - **Every identifier is real** — commands, paths, flags, env vars, endpoints, types, and defaults each traceable to a file you read. A plausible-looking invented flag is the single most expensive error this floor exists to prevent, because **a fabricated code sample is executed by the reader**, on their machine, not yours. - **Task-shaped headings, active voice** — headings name what the reader does ("Configure the database"), not what the system is ("Database configuration"). "Run the migration" over "The migrat