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 0 stars 0 forks Updated today Apache-2.0

Install

View on GitHub

Quality Score: 78/100

Stars 20%
0
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
1 months ago
Last Updated
today
Language
JavaScript
License
Apache-2.0

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

human-writing

Use when drafting, rewriting, proofreading, diagnosing, or adapting source-grounded prose, especially technical articles, essays, tutorials, product notes, and social posts, while preserving facts, attribution, uncertainty, voice, and meaning. Supports private English-first reasoning for Chinese finals; not translation-only, fiction, or AI-detection evasion.

2 Updated today
idaibin
AI & Automation Solid

human-rewrite

The repair pass on text that already exists — an agent's own last output, a subagent's report, a supplied document, a research summary, a legal or medical paragraph — rewritten so a person can read it fast and act on it, without changing what it claims. Meaning-preserving by contract: uncertainty, scope conditions, numbers, sample sizes, attribution, absent results, and reversing caveats all survive. Works on any subject, not just software. Trigger phrases: "/human-rewrite", "translate that into human", "that was a wall of text", "I can't follow this", "say that again but readable", "shorten this without losing anything". Not /human-output (the writing contract, which this skill links to rather than restates) or /human-draw (builds a picture) — human-rewrite governs the transformation of text that already exists.

0 Updated today
allemaar
AI & Automation Solid

human-draw

Renders information as a picture a person reads at a glance. Seven shapes — bar, spine, tree, lane, fork, matrix, small-multiple — drawn in printable ASCII on a monospace grid. Works on any subject: a budget, a harvest, a rota, a roof, a decision. Trigger phrases: "/human-draw", "draw this", "show me this visually", "make a diagram of this", "I can't hold all this in my head". Not /human-output (governs the prose around the figure, and runs alongside this skill rather than before it). Not /human-rewrite (repairs existing text, and hands material here when it turns out relational). This skill builds the text figure that survives copy-paste into any terminal.

0 Updated today
allemaar