Audio Script Writer

Overview

Content transformation tool that converts written medical and scientific materials into professionally structured audio scripts suitable for podcasts, educational videos, audiobooks, and voiceover narration.

Key Capabilities:

• - Format Conversion: Research papers → podcast scripts
• Spoken Word Optimization: Sentence restructuring for listening
• Pronunciation Guides: Medical terminology phonetic spelling
• Timing Estimation: Duration calculations for production planning
• Multi-Format Output: Podcast, video, lecture, audiobook templates
• Voice Direction: Tone, pace, and emphasis cues for narrators

When to Use

✅ Use this skill when:

• - Creating medical education podcasts from journal articles
• Converting conference presentations to video scripts
• Developing audiobook versions of medical textbooks
• Scripting patient education audio materials
• Producing research summary videos for social media
• Adapting written case reports for audio case studies
• Creating voiceover scripts for e-learning modules

❌ Do NOT use when:

• - Live presentation without script → Use improvisation
• Highly visual content (surgery videos) → Use visual-focused tools
• Interactive audio (Q&A format) → Use dialogue scripting tools
• Music or sound design planning → Use audio production software
• Voice recording itself → This creates scripts, not audio

Integration:

• - Upstream: abstract-summarizer (content condensation), lay-summary-gen (patient-friendly language)
• Downstream: medical-translation (multi-language scripts), voice-cloning-tool (AI narration)

Core Capabilities

1. Spoken Word Transformation

Convert written text to conversational audio style:

CODEBLOCK0

Transformation Rules:

2. Pronunciation Guide Generation

Create phonetic spelling for medical terms:

CODEBLOCK1

Guide Elements:

• - Phonetic Spelling: IPA or simplified phonetics
• Syllable Breaks: hy-per-ten-sion
• Emphasis Marking: Primary stress (CAPS), secondary stress
• Alternative Pronunciations: Regional variations (UK vs US)
• Sound-Alikes: "rhymes with..." for difficult terms

3. Timing and Pacing

Calculate speaking duration and mark pacing cues:

CODEBLOCK2

Speaking Rates:

Pacing Cues:
CODEBLOCK3

4. Multi-Format Templates

Generate scripts for different audio formats:

CODEBLOCK4

Format Types:

Common Patterns

Pattern 1: Research Paper to Podcast

Scenario: Convert published study to 15-minute podcast episode.

CODEBLOCK5

Structure:
CODEBLOCK6

Pattern 2: Medical Lecture Recording

Scenario: Convert lecture notes to video script for online course.

CODEBLOCK7

Lecture Elements:

• - Learning objectives at start
• Periodic comprehension checks
• Break reminders
• Transition phrases between topics
• Summary and key takeaways

Pattern 3: Patient Education Audio

Scenario: Create audio guide for diabetes management.

CODEBLOCK8

Patient Script Features:

• - Simple language (avoid medical jargon)
• Empathetic tone
• Clear action steps
• Reassuring statements
• Repetition of key points

Pattern 4: Conference Presentation to Video

Scenario: Adapt live presentation to YouTube video format.

CODEBLOCK9

YouTube Optimization:

• - Hook in first 30 seconds
• Engagement questions for comments
• Call to action (subscribe, like)
• Timestamp markers for chapters
• B-roll suggestions for visual interest

Complete Workflow Example

From research paper to published podcast:

CODEBLOCK10

Python API:

CODEBLOCK11

Quality Checklist

Content Quality:

• - [ ] Written content accurate and current
• [ ] Sources cited (even if not spoken)
• [ ] Medical facts verified by expert
• [ ] Appropriate for target audience level
• [ ] No confidential patient information

Audio Optimization:

• - [ ] Sentences 15-20 words maximum
• [ ] Abbreviations expanded on first use
• [ ] Complex terms have pronunciation guides
• [ ] Active voice preferred over passive
• [ ] Transitions smooth and conversational

Production Quality:

• - [ ] Timing realistic for content density
• [ ] Pacing cues appropriate for subject
• [ ] Music/sound cues marked clearly
• [ ] Pronunciation guide comprehensive
• [ ] Script formatted for easy reading

Before Recording:

• - [ ] CRITICAL: Script read aloud for flow
• [ ] Difficult pronunciations practiced
• [ ] Timing tested with stopwatch
• [ ] Technical terms confirmed with subject expert
• [ ] Copyright cleared for any quoted material

Common Pitfalls

Content Issues:

• - ❌ Too dense → Information overload for listeners

• - ❌ Visual dependencies → "As shown in Figure 3..."

• - ❌ Citation overload → Every sentence has reference

Audio Issues:

• - ❌ Written-style language → "Furthermore, the aforementioned..."

• - ❌ No pauses → Relentless information delivery

• - ❌ Ignoring pronunciation → Mispronounced medical terms

Production Issues:

• - ❌ Underestimating time → 10 minutes of script takes 12+ to record

• - ❌ Complex sentence structures → Tongue twisters for narrator

References

Available in references/ directory:

• - audio_writing_best_practices.md - Broadcast writing guidelines
• INLINECODE6 - Common terms phonetics
• INLINECODE7 - Industry format standards
• INLINECODE8 - Inclusive audio content
• INLINECODE9 - YouTube, Spotify, Apple specs
• INLINECODE10 - Narrator health and performance

Scripts

Located in scripts/ directory:

• - main.py - CLI interface for script conversion
• INLINECODE13 - Core text-to-audio transformation
• INLINECODE14 - Medical terminology phonetics
• INLINECODE15 - Duration calculation and pacing
• INLINECODE16 - Podcast, video, lecture templates
• INLINECODE17 - Narrator cues and direction
• INLINECODE18 - Alternative format generation

Limitations

• - Voice Performance: Script is text only; actual delivery varies by narrator
• Accent Variations: Pronunciation guides may not match all dialects
• Cultural Context: Humor and references may not translate across cultures
• Copyright: Cannot use copyrighted material without permission
• Technical Accuracy: Does not verify medical content (input-dependent)
• Live Elements: Cannot script unscripted interviews or Q&A

Parameters

Usage

Basic Usage

CODEBLOCK12

Risk Assessment

Security Checklist

• - [x] No hardcoded credentials or API keys
• [x] No unauthorized file system access
• [x] Output does not expose sensitive information
• [x] Prompt injection protections in place
• [x] Input validation for file paths
• [x] Output directory restricted to workspace
• [x] Script execution in sandboxed environment

Prerequisites

CODEBLOCK13

Evaluation Criteria

Success Metrics

• - [x] Successfully converts text to audio-optimized script
• [x] Expands abbreviations and converts numbers to words
• [x] Calculates estimated duration based on word count
• [x] Applies style-specific formatting
• [x] Provides pronunciation notes for medical terms

Test Cases

1. 1. Basic Conversion: Convert text file → Returns audio script with metadata
2. Abbreviation Handling: Text with "e.g., i.e., etc." → All expanded in output
3. Number Conversion: Input with "1 in 4" → Output with "one in four"

Lifecycle Status

• - Current Stage: Draft
• Next Review Date: 2026-03-06
• Known Issues: None
• Planned Improvements: