clear-explanationlisted
Install: claude install-skill ek0212/agent-ready-repo-kit
# Clear Explanation
Turn complex ideas into audience-fit explanations. Use CLEAR: Calibrate, Link, Envision, Abstract, Repeat.
## Scope
Use for explanations, rewrites, teaching notes, stakeholder summaries, beginner-friendly descriptions, and jargon translation.
Do not use for narrative craft, academic literature synthesis, outreach email, newsletter strategy, AI-pattern cleanup, or visual UI design unless explanation clarity is main job.
## Inputs
- Topic or draft.
- Audience and their familiarity.
- Desired channel: spoken, email, doc, slide, comment.
- Length limit, if any.
- Must-keep terms, facts, caveats, or legal/security constraints.
If audience missing, infer only when safe. Otherwise ask one calibration question.
## Workflow
### Step 1: Calibrate
Set audience level before explaining.
- Beginner: no jargon. Define needed terms.
- General professional: use common business/technical words.
- Specialist: keep field terms, remove needless complexity.
- Mixed audience: explain in layers, simple first, details after.
If interactive, ask: "How familiar are they with this topic?" If not interactive, state assumed level.
### Step 2: Link
Connect unknown to known.
Use one analogy, metaphor, or familiar comparison when it reduces effort. Keep link close to audience world. Drop analogy if it hides important differences.
Pattern:
```text
Think of [complex thing] like [known thing]. The important similarity: [shared structure]. The limit: [where analogy stops].
``