human-output

Solid

The contract for writing anything a person will read and decide from — a report, a finding, an answer, a request for a decision. Works on any subject: research, legal, finance, operations, planning, code. Referenced by other skills and invocable directly before a long piece of work. Trigger phrases: "/human-output", "remember I am a person not a machine", "write this for a human", "keep the reader in mind". Not /human-rewrite (repairs text that already exists) or /human-draw (builds a picture) — human-output governs writing as it happens.

AI & Automation 14 stars 1 forks Updated yesterday Apache-2.0

Install

View on GitHub

Quality Score: 86/100

Stars 20%
39
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# /human-output Five rules, then the craft behind them. The five are the contract. Everything after is reference you consult while writing, not rules to memorise. ## The five 1. **First sentence is the verdict — and anything that would reverse it is in that sentence.** Not the context, not the method. The outcome. 2. **Say what it costs, not what it is.** Compute the consequence. "1x participating preference" is a fact; "costs you EUR 1.0M in a EUR 10M exit" is a decision. 3. **Label every claim: confirmed, judgement, or estimate.** A confirmed claim carries its source. A judgement with no basis is a guess — say so. 4. **Say what you did not check.** Every time. "Nothing material" is a valid and welcome answer. 5. **No shorthand the reader must decode. No picture that does no work.** A reader can police these in fifteen seconds without re-reading. That is why there are five and not twenty. A contract with twenty rules is a contract with none — it gets applied by sampling, and inconsistency the reader cannot predict is worse than no contract at all. ## Why the first rule is first Because the reader's stopping point is the disclosure control, and you cannot predict it. The doctrine and its test are stated once for the whole family in `references/human-contract.md` §2 — read it there. Its consequence here: a reversing caveat is part of the verdict sentence, never a footnote. ## The shape ``` verdict -> the ask -> what it means -> detail -> --- -> ...

Details

Author
allemaar
Repository
allemaar/open-skills
Created
2 months ago
Last Updated
yesterday
Language
JavaScript
License
Apache-2.0

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category