Individual skill
s4h-writing-audience-calibration
Calibrates writing for a specific reader by profiling their knowledge, concerns, and relationship to the topic — then rewriting for that reader without changing the substance. Use when content is too technical, too basic, or framed for the wrong audience. Triggers: 'write for a specific audience', 'audience calibration', 'this needs to work for non-technical readers', 'the audience isn't the right fit', 'calibrate this for', 'it's too technical / not technical enough', 'recalibrate this for'.
skills/s4h-writing-audience-calibration/SKILL.md
Source commit a30df8b67698ccb03ef5e35d68c2eddc5321ad3f
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- Yes
- Observed behavior
- Not checked yet
- Last checked
- Nov 5, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 239
- Repository last updated
- Jul 15, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- claude-code Repository topic
- claude-code-plugin Repository topic
- cognitive-frameworks Repository topic
- creativity Repository topic
- decision-making Repository topic
- ethics Repository topic
- mental-models Repository topic
- problem-solving Repository topic
- reasoning Repository topic
- systems-thinking Repository topic
- writing Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 7,727 bytes
Read excerpt
# Writing: Audience Calibration
Calibration failures come in two forms: over-explanation and under-explanation. Over-explanation treats experts as novices — it defines terms they know, explains concepts they've mastered, and adds context they don't need. This reads as condescending, and the expert reader disengages. Under-explanation treats novices as experts — it uses jargon without definition, assumes mental models the reader doesn't have, and skips the connections that make the logic followable. This reads as inaccessible, and the novice reader gives up.
The critical insight: calibration does not require changing the substance of what is being communicated. The same analysis can serve a technical expert and a non-technical decision-maker if it is correctly calibrated for each. The facts don't change; the entry point, assumed knowledge, vocabulary, framing, and emphasis all do.
The three dimensions of calibration:
- **Knowledge calibration:** What does this reader already know? What can be assumed, what needs brief context, what needs explanation?
- **Stakes calibration:** What does this reader care about? The engineer cares about implementation; the product manager cares about user impact; the executive cares about business consequences. Same finding, different emphasis.
- **Relationship calibration:** Is the reader expert or novice, friendly or skeptical, time-pressed or engaged? Each requires different structural choices.
---
## Your Process