human-output

Applies a five-rule contract for writing decision-ready prose for human readers.

14|1|Updated Jun 14, 2026
One-click install
npx skills add https://github.com/allemaar/open-skills --skill human-output-allemaar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: human-output
Source: https://github.com/allemaar/open-skills/tree/main/skills/human-output
Command: npx skills add https://github.com/allemaar/open-skills --skill human-output-allemaar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Reports, findings, and answers written for people often bury the verdict, hide costs behind jargon, and omit what was never checked, forcing readers to reconstruct the decision themselves. This Skill enforces a five-rule writing contract so any output a person reads is decidable within seconds. ## Core Features & Use Cases - Five-rule contract: verdict first with reversing caveats included, consequences computed rather than facts named, claims labelled confirmed/judgement/estimate, unchecked items stated, and no shorthand or decorative figures. - Mechanical checker: a bundled Node.js script (references/tools/human-output-check.mjs) grades acronym expansion, sentence length, fence width, bar proportionality, and percentage sums before text is sent. - Shared family doctrine: references/human-contract.md defines the stopping-point doctrine, routing across the human- family (rewrite, draw, merge), and a portable style floor. - Use Case: Before delivering a term-sheet analysis, run the draft through the checker and apply the contract so the first sentence states the verdict and its cost, each claim carries a confidence label, and the one unchecked fact governing the negotiation is named. ## Quick Start Ask the agent to write the report following the human-output contract and run the bundled checker on the draft before sending it.

Frequently Asked Questions about human-output

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make AI-written reports decision-ready for human readers?

Apply the five-rule contract: put the verdict and any reversing caveat in the first sentence, compute consequences instead of naming facts, label claims as confirmed, judgement, or estimate, state what was not checked, and remove shorthand and decorative figures.

How do I check a draft against the human-output contract?

Run node references/tools/human-output-check.mjs with the draft file path, or pipe text via stdin. The checker exits 0 when no errors exist and reports acronym, sentence-length, fence-width, bar-proportionality, and percentage-sum findings.

What does the human-output checker not verify?

The checker grades only mechanical rules. It cannot judge whether the first sentence is truly the verdict, whether confidence labels are correct, whether unchecked items are honestly stated, or whether numbers in prose trace back to source material.

When should I use human-rewrite instead of human-output?

Use human-rewrite when text already exists and needs repair rather than authoring. human-output governs writing as it happens; human-rewrite applies the same contract to somebody else's existing text, and human-merge combines several separate reports.

Does the length limit apply to security or financial topics?

No. Length limits are suspended for irreversible or destructive actions, security or credentials, money, legal exposure, production deploys, and migrations. Fidelity is a floor that never yields to a length target; report conflicts instead of cutting substance.