human-rewrite

Rewrites existing text for readability while preserving all claims, caveats, and numbers.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Existing text — an agent's report, a subagent summary, a legal or medical paragraph — is often correct but unreadable, and naive rewriting silently upgrades confidence, drops caveats, or loses numbers. This Skill repairs such text so a person can read it fast and act on it, without changing what it claims. ## Core Features & Use Cases - Fidelity-guaranteed rewriting: Seven guarantees (uncertainty, scope, numbers, sample basis, attribution, absent results, reversing caveats) survive every rewrite unchanged. - Seven-step repair procedure: Inventory the fidelity set, find the verdict, hoist reversing caveats, cut additive noise, restack by decision relevance, reconcile against the inventory with a visible trace, and run a cold confidence-drift test. - Mechanical checker: A bundled Node.js script (references/tools/human-output-check.mjs) grades the mechanical half of the output contract — sentence length, acronym expansion, fence width, bar proportionality, and percentage sums. - Use Case: A subagent returns a dense 800-word investigation report. Run the rewrite to produce a verdict-first, decision-ordered version with a fidelity trace confirming all 12 load-bearing items survived. ## Quick Start Ask the agent to rewrite the attached report so a person can read it quickly, without changing any of its claims, numbers, or caveats.

Frequently Asked Questions about human-rewrite

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

FAQPage Schema
How do I rewrite a report without losing important caveats?

Inventory every uncertainty, scope condition, number, sample size, attribution, absent result, and reversing caveat before rewriting, then reconcile the output against that list item by item. The Skill emits a fidelity trace confirming each item was carried, compressed-but-named, or dropped.

How to make AI-generated text more readable without changing its meaning?

Restack the text by decision relevance rather than work chronology, cut only additive noise like process narration and restatements, and keep all seven fidelity guarantees intact. Finish with a cold confidence-drift test comparing how sure your version sounds against the source.

Can this rewrite text from any subject, not just software?

Yes, the Skill works on any subject including legal, medical, and research text. It reads the material's shape rather than its topic, and includes a worked example rewriting an estuary water-quality report.

What are the limitations of automated text rewriting?

The bundled checker only grades mechanical rules like sentence length and acronym expansion; verdict placement, confidence labeling, and number-to-source tracing remain human judgement. The Skill also refuses to merge multiple separate reports, routing that to a dedicated merge skill instead.

Why does rewriting sometimes make text sound more confident than the source?

Brevity passes delete hedges first, short declarative sentences read as confident, and dropping attribution turns claims into facts. The Skill treats any confidence increase as a mistranslation and provides word-level drift detectors to catch it.