concise-docs
Installation
SKILL.md
Concise Docs
Readers skim: headings first to get the structure, then visuals to get the gist, and prose last to fill in details. These rules turn every section into a unit that can be read at a glance — a format already proven to make documents both quick to read and clear.
Section Rules
A section is any heading (including H1) plus the content directly under it, up to the next heading.
| Rule | Limit | Why |
|---|---|---|
| Visual | At least one ASCII diagram, table, code block, or numbered list of 3+ steps | Structure reads faster as a visual; the visual anchors the section |
| Length | At most 100 Chinese characters; 150 English words | A section that swells breaks the reading rhythm |
| Sentence | At most 50 Chinese characters; 25 English words (soft) | Each extra clause is one more thing to hold in mind |
| List | At most 6 unordered items (soft) | Readers lose their place past six; a table scans by column |
| Table | At most 4 columns; at most 15 units per cell | Wide or wordy tables squeeze columns until they stop scanning |
| Emphasis | Bold near 5% of prose (soft); table bold exempt | Emphasis works only when rare; everywhere means nowhere |
| Heading | 2-3 word definite noun phrase (soft); section numbers like 1.1. not counted |
Headings are the table of contents; each should say what is there |