Transform comprehensive written content into purposeful spoken guidance. Use when adapting for speech, converting to spoken format, optimizing for listening, or creating audio content from written material. Keywords: speech, audio, spoken, listening, adaptation, podcast.
npx skills add https://github.com/jwynia/agent-skills --skill speech-adaptation
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.
Lead with value, earn attention. Listeners can't skim. Front-load what matters and offer expansion rather than exhaustive delivery.
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 |
| 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 |
Written: Lists methods 1-7 equally
Spoken: "There are three main approaches. Start with [most relevant]. If that doesn't work, try [backup]."
Written: Builds up to key insights
Spoken: Lead with core insight, then supporting details if needed
Written: Seven distinct frameworks
Spoken: "Basically three strategies: sort by importance, limit your focus, or batch similar work"
Written: Explains everything at same depth
Spoken: Start simple, indicate where more detail is available
Remove in Speech:
Add for Speech:
| 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 |
| 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? |
Question Type: Immediate problem-solving with overwhelm signals
Written Response: 7 methods with full explanations
Spoken Adaptation:
Inbound:
Outbound:
Complementary:
presentation-design: For visual + spoken coordinationdialogue: For conversational delivery patternsPattern: 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.
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.
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.
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.
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."
| Skill | What it provides |
|-------|------------------|
| prose-style | Written content quality to work from |
| (written documentation) | Source material for adaptation |
| 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 |
| 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 |
Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.
Improves the quality of images, especially screenshots, by enhancing resolution, sharpness, and clarity. Perfect for preparing images for presentations, documentation, or social media posts.
Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.
Lightweight WSI tile extraction and preprocessing. Use for basic slide processing tissue detection, tile extraction, stain normalization for H&E images. Best for simple pipelines, dataset preparation, quick tile-based analysis. For advanced spatial proteomics, multiplexed imaging, or deep learning pipelines use pathml.
Microscopy data management platform. Access images via Python, retrieve datasets, analyze pixels, manage ROIs/annotations, batch processing, for high-content screening and microscopy workflows.
Python library for working with DICOM (Digital Imaging and Communications in Medicine) files. Use this skill when reading, writing, or modifying medical imaging data in DICOM format, extracting pixel data from medical images (CT, MRI, X-ray, ultrasound), anonymizing DICOM files, working with DICOM metadata and tags, converting DICOM images to other formats, handling compressed DICOM data, or processing medical imaging datasets. Applies to tasks involving medical image analysis, PACS systems, radiology workflows, and healthcare imaging applications.
This skill should be used when working with pre-trained transformer models for natural language processing, computer vision, audio, or multimodal tasks. Use for text generation, classification, question answering, translation, summarization, image classification, object detection, speech recognition, and fine-tuning models on custom datasets.
Take jwynia/speech-adaptation from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.