writing-audience-calibration

Profile a target reader and rewrite content framing without changing substance.

212|23|Updated May 23, 2026
One-click install
npx skills add https://github.com/human-avatar/skills-for-humanity --skill writing-audience-calibration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-audience-calibration
Source: https://github.com/human-avatar/skills-for-humanity/tree/main/skills/writing-audience-calibration
Command: npx skills add https://github.com/human-avatar/skills-for-humanity --skill writing-audience-calibration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It fixes writing that fails because it’s calibrated to the wrong reader—too technical, too basic, or framed for an audience that doesn’t match the reader’s knowledge, stakes, or relationship to the topic.

Core Features & Use Cases

  • Reader profiling: Builds a concrete reader model (knowledge, role, stakes, relationship, and time) to decide what should be assumed vs. explained.
  • Calibration failure detection: Flags jargon without definitions, over-explanation, wrong assumed prior context, wrong emphasis, and incorrect entry point.
  • Framing adjustment without substance changes: Rewrites the opening and key framing so the same facts land correctly via mechanism→outcome, policy→specification, and emphasis shifts.
  • Targeted output: Produces a calibration report plus a rewritten opening paragraph calibrated to the chosen reader.

Quick Start

Rewrite your existing draft for a specific audience by running writing-audience-calibration and pasting the text plus the reader profile (knowledge level, role, stakes, relationship, and how much time they have).

Frequently Asked Questions about writing-audience-calibration

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

FAQPage Schema
How do I rewrite technical content for a non-technical executive audience?

To rewrite technical content for a non-technical executive audience, profile the reader's knowledge and stakes, identify jargon or over-explanation, and adjust the framing to emphasize outcomes without changing the underlying substance.

What is audience calibration in executive communication?

Audience calibration in executive communication is the process of profiling a reader's knowledge and relationship to a topic, detecting framing failures like jargon, and rewriting the content so the same facts land correctly for that specific reader.

How do I fix a draft that buries the reader's highest-value question?

To fix a draft that buries the reader's highest-value question, you profile the target reader, detect wrong emphasis or incorrect entry points, select the highest-value question, and rewrite the opening paragraph to lead with that answer.

Can I adjust the framing of a document without changing the substance?

Yes, you can adjust framing without changing substance by shifting the entry point from mechanism to outcome or policy to specification, selecting the reader's highest-value question, and rewriting the opening paragraph accordingly.

What causes writing to fail with the wrong reader even when the facts are correct?

Writing fails with the wrong reader when it is calibrated incorrectly—using wrong vocabulary, assuming an incorrect prior mental model, or burying the reader's highest-value question—causing the facts to land poorly despite being accurate.

When should I use audience calibration instead of simplifying my writing?

Use audience calibration instead of just simplifying when your text is too technical or too basic, uses wrong vocabulary, or assumes an incorrect prior mental model, requiring a reader profile and framing shift rather than basic text simplification.