structured-writing — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited structured-writing (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
Most writing fails by burying the point. A structured document leads with the conclusion, supports it with grouped evidence, and lets the reader stop reading the moment they have what they need.
| Structure | Best for | Lead |
|---|---|---|
| BLUF (Bottom Line Up Front) | Emails, status updates, requests | The ask or the answer |
| Minto Pyramid | Reports, strategy memos, analyses | The single governing thought |
| Inverted pyramid | News-style updates, announcements | The headline fact |
| SPQR (Situation-Problem-Question-Resolution) | Briefs, consulting narratives | The situation, built to the ask |
Pick by reader, not by habit. A busy executive needs BLUF; a peer reviewing analysis needs a pyramid; a team reading an announcement needs inverted pyramid.
A BLUF message opens with: the ask, the answer, or the conclusion — in under 30 words — followed by supporting detail the reader can skip.
BLUF: [ask / decision / answer in one sentence]
Why it matters:
- [reason 1 in ≤12 words]
- [reason 2]
Details (only if the BLUF doesn't answer their question):
- [supporting fact with number]
- [supporting fact with reference]
What I need from you:
- [explicit ask with deadline] or "FYI — no action needed."Rules:
Full worked examples and email/Slack/standup templates in references/bluf-templates.md.
Barbara Minto's pyramid: every document has one governing thought, supported by 3-5 grouped arguments, each supported by evidence.
Governing thought
(what + why + so-what)
|
┌───────────────┼───────────────┐
Argument 1 Argument 2 Argument 3
| | |
Evidence Evidence EvidenceRules:
See references/minto-pyramid-method.md for the question-answer logic, MECE groupings, and the SCQ (Situation-Complication-Question) introduction.
When the reader needs context before the ask:
Useful for consulting-style briefs, board materials, vendor proposals. Less useful for async team updates (use BLUF instead).
Structured writing is skim-tested, not read-tested. Before sending, ask:
If any answer is no, restructure before polishing words.
clarity-editing.| File | Contents |
|---|---|
references/bluf-templates.md | BLUF templates for email, Slack, standup updates, PR descriptions with worked examples |
references/minto-pyramid-method.md | Full Minto method — governing thought, MECE arguments, SCQ intros, question-answer logic |
references/structure-selection-matrix.md | Reader × purpose × medium matrix for picking the right structure |
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.