speech-adaptation
npx skills add https://github.com/jwynia/agent-skills --skill speech-adaptation
Agent 安装分布
Skill 文档
Speech Adaptation
Purpose
Transform comprehensive written content into purposeful spoken guidance. Speech requires 3-5x compression while maintaining functional value. Apply when converting written content to audio, podcasts, presentations, or voice assistant responses.
Core Principle
Lead with value, earn attention. Listeners can’t skim. Front-load what matters and offer expansion rather than exhaustive delivery.
Functional Intent Detection
Parse the original question/content for intent:
| Intent Type | Signals | Focus |
|---|---|---|
| Problem-solving | “How do I…” | Actionable steps |
| Learning | “What is…” | Core concepts + examples |
| Decision-making | “Should I…” | Key considerations + recommendation |
| Troubleshooting | “Why isn’t…” | Likely causes + solutions |
Context Signals
| Signal Type | Examples | Adaptation |
|---|---|---|
| Urgency | “today”, “now”, “urgent” | Compress to immediate next steps |
| Scope | “huge”, “complex”, “overwhelming” | Lead with simplification |
| Experience | “beginner”, “new to” | Increase explanation, decrease jargon |
| Personal stakes | “I”, “my project” | Increase specificity, decrease abstraction |
Content Transformation Principles
1. Hierarchical Restructuring
Written: Lists methods 1-7 equally Spoken: “There are three main approaches. Start with [most relevant]. If that doesn’t work, try [backup].”
2. Front-Load Value
Written: Builds up to key insights Spoken: Lead with core insight, then supporting details if needed
3. Compress Conceptual Space
Written: Seven distinct frameworks Spoken: “Basically three strategies: sort by importance, limit your focus, or batch similar work”
4. Context-Dependent Detail
Written: Explains everything at same depth Spoken: Start simple, indicate where more detail is available
- “Use a priority matrix – urgent versus important”
- Optional expansion cue: “I can break down those four categories if helpful”
5. Eliminate Structural Artifacts
Remove in Speech:
- Section headers read verbatim
- Bullet point enumeration
- Visual formatting cues
- Redundant category labels
Add for Speech:
- Transition phrases between ideas
- Purpose statements before methods
- Summary/recap statements
6. Progressive Revelation Strategy
- Core insight (one sentence)
- Primary recommendation (actionable step)
- Backup approach (if primary doesn’t fit)
- Availability cue for additional methods
Implementation Guidelines
Pre-Processing Steps
- Parse original question for functional intent and context signals
- Identify 1-2 most relevant pieces for their specific need
- Determine appropriate compression ratio based on urgency/complexity
Content Selection Rules
| Context | Selection |
|---|---|
| High urgency | 1 primary method + 1 backup |
| Learning focused | Core concept + 1 detailed example + availability of more |
| Decision support | Key considerations + clear recommendation |
| Complex topic | Simplify conceptual framework first, offer detail expansion |
Speech-Specific Adaptations
- Replace structural language with functional language
- Add explicit transitions between ideas
- Use pronouns and referential terms to avoid repetition
- Include “escape valves” for different user needs
- End with clear next step or summary
Quality Checks
| Test | Question |
|---|---|
| Compression | Is this 30-50% of original length? |
| Completeness | Does this answer their core question? |
| Flow | Would this make sense heard linearly? |
| Action | Do they know what to do next? |
Example Transformation
Question Type: Immediate problem-solving with overwhelm signals
Written Response: 7 methods with full explanations
Spoken Adaptation:
- Acknowledge state: “When facing a huge list…”
- Core insight: “The key is separating what needs doing from what feels urgent”
- Primary action: “Try this: scan for things both urgent AND important”
- Boundary setting: “Pick just 3 – more than that sets you up to feel behind”
- Escape valve: “Other approaches available if this doesn’t click”
Success Metrics
- User can act immediately after listening
- Cognitive load feels manageable
- Key insights retained after single hearing
- Optional detail access feels natural when needed
Integration Points
Inbound:
- From written documentation or articles
- From comprehensive analysis outputs
- From detailed framework content
Outbound:
- To audio content production
- To presentation delivery
- To voice assistant responses
Complementary:
presentation-design: For visual + spoken coordinationdialogue: For conversational delivery patterns
Anti-Patterns
1. Uniform Compression
Pattern: Reducing all content by the same ratio regardless of importance. Why it fails: Not all content is equal. Some ideas need full explanation; others can be summarized in a phrase. Equal compression buries critical insights and pads trivial ones. Fix: Identify the 1-2 most important points. Protect those while ruthlessly compressing supporting material. Lead with what matters most.
2. Written Sentences Spoken
Pattern: Reading written prose aloud without restructuring for speech patterns. Why it fails: Written and spoken language have different rhythms, sentence structures, and information density. Written sentences spoken sound formal, awkward, and hard to follow. Fix: Restructure for oral delivery. Shorter sentences. More personal pronouns. Explicit transitions. Repetition for emphasis. Natural breathing points.
3. Exhaustive Completeness
Pattern: Including all information from the written source because “it might be important.” Why it fails: Listeners can’t skim, reread, or control pace. Information overload in speech creates immediate cognitive overload and retention collapse. Fix: Accept that spoken content is selective. Provide escape valves: “More on this if helpful.” Trust that listeners can ask for expansion rather than front-loading everything.
4. Missing Signposts
Pattern: Moving between ideas without explicit verbal transitions. Why it fails: Listeners can’t see paragraph breaks or headings. Without verbal signposts, ideas blur together. The structure becomes invisible. Fix: Add explicit transitions: “First…” “More importantly…” “Here’s the key point…” “Moving on to…” Make the structure audible.
5. Buried Action
Pattern: Leaving actionable recommendations for the end after extensive context. Why it fails: Listeners who zone out during context miss the action items. Those still engaged have forgotten the details by the time recommendations arrive. Fix: Front-load action with context to follow. “Do X. Here’s why…” rather than “Here’s all the context, therefore do X.”
Integration
Inbound (feeds into this skill)
| Skill | What it provides |
|---|---|
| prose-style | Written content quality to work from |
| (written documentation) | Source material for adaptation |
Outbound (this skill enables)
| Skill | What this provides |
|---|---|
| presentation-design | Spoken content structure for slide coordination |
| (audio production) | Scripts ready for recording |
| (voice assistants) | Responses optimized for spoken delivery |
Complementary
| Skill | Relationship |
|---|---|
| presentation-design | Speech-adaptation handles the spoken component; presentation-design coordinates visual and spoken elements |
| dialogue | Speech-adaptation for informational delivery; dialogue for conversational and dramatic speech patterns |