enforce-scannable-density
Edit a portfolio case study for high signal, compact hierarchy, and fast scanning without losing evidence. Use when a draft is fluffy, repetitive, slow to navigate, paragraph-heavy, full of generic pr
SKILL.mdskills/enforce-scannable-density/SKILL.md
GitHubEnforce Scannable Density
Make complexity easier to find, not merely shorter. Apply the reduction, organization, and time-to-understand passes in references/density-pass.md.
Workflow
- Write the reader’s five highest-value questions.
- Measure whether the answer to each is visible in the title, summary, headings, captions, or first sentence of a section.
- Remove throat-clearing, repeated context, passive constructions, generic process claims, and unsupported praise.
- Group related evidence and give each section one job.
- Move the outcome, constraint, and pivotal decision earlier.
- Choose the lightest fitting form:
- prose for causal explanation;
- bullets for non-sequential factors;
- key-value blocks for compact facts;
- tables only for records with shared comparable fields;
- monospace blocks only for commands, logs, or technical specifications.
- Preserve quantitative data, caveats, ownership, attribution, and evidence labels.
- Run a 30-second scan test and list any answer still difficult to locate.
Never manufacture density by shrinking type, stacking unrelated facts, turning prose into decorative tables, or deleting uncertainty.
Output
Return the revised structure and copy, a cut/move/convert ledger, the five-question scan result, and any evidence weakened by the edit.
Example
Input:
We were very excited to embark on a comprehensive process that involved looking at
many different approaches before ultimately deciding on a new approvals experience.
Expected outcome:
Decision — Replace blanket approvals with risk-based gates.
Evidence needed — alternatives considered, approval threshold, and measured effect.