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'.

242 stars 25 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add human-avatar/skills-for-humanity --skill s4h-writing-audience-calibration
Manual install
git clone --depth 1 https://github.com/human-avatar/skills-for-humanity.git /tmp/skills-for-humanity
mkdir -p ~/.claude/skills
cp -r /tmp/skills-for-humanity/skills/s4h-writing-audience-calibration ~/.claude/skills/s4h-writing-audience-calibration

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# 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
Read the full skill on GitHub

Details

Skill name
s4h-writing-audience-calibration
Path
skills/s4h-writing-audience-calibration/SKILL.md
License
MIT
Repo updated
15 July 2026

FAQ

What does the S4h Writing Audience Calibration skill do?

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'.

How do I install the S4h Writing Audience Calibration skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add human-avatar/skills-for-humanity --skill s4h-writing-audience-calibration. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is S4h Writing Audience Calibration popular?

It lives in human-avatar/skills-for-humanity, which has 242 GitHub stars and 25 forks, and is included in 1 curated skill list.

Related skills

S4h

242

human-avatar/skills-for-humanity

Master orchestration skill. Takes any situation in plain English, identifies the underlying goal, designs a multi-skill reasoning workflow, and executes it sequentially — feeding each skill's output into the next. Use when you say 'help me think through this', 'I need to figure out what to do', 'where do I start', or any time you want structured thinking applied end-to-end rather than routed to a single tool.

Testing & QAIn 1 list25

S4h Aesthetic

242

human-avatar/skills-for-humanity

Entry point for the aesthetic toolkit. Routes to the right aesthetic skill based on your situation. Use when you say 'aesthetic', 'check the design', 'does this feel right', 'is this elegant', 'is this too complex', 'what pattern is this', 'find the simpler version', or want an aesthetic lens applied without knowing which specific tool fits.

OtherIn 1 list25

S4h Aesthetic Coherence Check

242

human-avatar/skills-for-humanity

Tests whether the parts of something form a unified whole — finding the jarring inconsistencies that accumulate when different contributors work without a shared vision. TRIGGERS: 'coherence check', 'does this feel unified', 'something feels off', 'inconsistent', 'check the whole', 'does this hang together'.

Testing & QAIn 1 list25

S4h Writing Copy

242

human-avatar/skills-for-humanity

Writes and audits marketing copy, landing pages, ad copy, email copy, and product descriptions using the attention-desire-action framework. Use when copy isn't converting, describes features instead of benefits, or fails to earn the reader's next step. Triggers: 'copywriting', 'ad copy', 'landing page', 'email copy', 'marketing copy', 'write copy', 'the copy isn't converting', 'product description', 'headline isn't working'.

Writing & ContentIn 1 list25

S4h Writing Argument

242

human-avatar/skills-for-humanity

Builds and repairs persuasive arguments by surfacing the warrant, auditing evidence, addressing counterarguments, and identifying rhetorical substitutes. Use when an argument has holes, the case isn't landing, or evidence isn't connecting to the claim. Triggers: 'build an argument', 'argument structure', 'the argument isn't working', 'op-ed', 'persuasive writing', 'make the case for', 'my argument has holes', 'the evidence doesn't land'.

Writing & ContentIn 1 list25

S4h Writing Dialogue

242

human-avatar/skills-for-humanity

Diagnoses and repairs dialogue for subtext, voice differentiation, exposition, and forward momentum. Use when dialogue sounds wrong, on-the-nose, or when characters all sound the same. Triggers: 'the dialogue sounds wrong', 'dialogue feels on the nose', 'dialogue review', 'characters sound the same', 'dialogue fix', 'dialogue is too direct', 'the dialogue explains too much'.

Writing & ContentIn 1 list25

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.