@kolbo/kolbo-code-linux-arm64-musl 1.1.72 → 1.1.73

package/skills/music-prompting/SKILL.md

@@ -0,0 +1,146 @@
+---
+name: music-prompting
+description: >
+  Music generation prompting guide: BPM selection by video type, key/mood mapping, prompt
+  structure for background music, duration matching, looping strategies, section-mapped scoring.
+  Use when generating background music for video or crafting music generation prompts.
+  Keywords: music, BPM, tempo, key, mood, instrumental, background music, suno, elevenlabs,
+  music generation, prompt, genre, looping, score, soundtrack
+---
+
+# Music Generation — Prompting Guide
+
+## Quick Reference
+
+```
+INSTRUMENTAL:     Always force_instrumental=true for video background
+PROMPT ORDER:     genre/style → BPM → key/mood → instruments → energy → purpose
+KEY RULE:         Music must be 18-20 dB below narration (see sound-design skill)
+ALWAYS INCLUDE:   "background" or "underscore" in every prompt
+```
+
+## BPM Selection by Video Type
+
+| Video Type | BPM Range | Prompt Fragment |
+|-----------|-----------|-----------------|
+| Educational explainer | 80-100 | "gentle ambient electronic, 90 BPM" |
+| Corporate / tech | 100-120 | "upbeat corporate pop, 110 BPM, positive" |
+| Epic / dramatic reveal | 60-80 | "cinematic orchestral, 70 BPM, building tension" |
+| Fast-paced montage | 120-140 | "energetic electronic, 130 BPM, driving beat" |
+| Meditation / calm | 50-70 | "ambient drone, 60 BPM, peaceful" |
+| Comedy / lighthearted | 100-130 | "playful ukulele pop, 120 BPM, whimsical" |
+| Sad / reflective | 60-80 | "melancholic piano, 65 BPM, minor key" |
+| Action / hype | 140-170 | "high-intensity drum and bass, 160 BPM" |
+
+## Key and Mood Mapping
+
+| Mood | Key | Musical Characteristics |
+|------|-----|----------------------|
+| Happy / upbeat | C major, G major | Bright, resolved, energetic |
+| Serious / professional | D minor, A minor | Grounded, authoritative |
+| Mysterious / curious | E minor, B minor | Tension, anticipation |
+| Triumphant / inspiring | D major, Bb major | Expansive, climactic |
+| Melancholic / thoughtful | F minor, C minor | Reflective, emotional |
+| Neutral / ambient | C major, Am | Unobtrusive, background |
+
+## Prompt Structure
+
+```
+[GENRE/STYLE], [BPM], [KEY/MOOD], [INSTRUMENTS], [ENERGY LEVEL], [PURPOSE]
+```
+
+### Examples
+
+**Educational explainer:**
+```
+Gentle lo-fi ambient electronic, 90 BPM, C major, soft synth pads and light
+percussion, calm and steady energy, background music for narration
+```
+
+**Corporate product demo:**
+```
+Modern upbeat corporate pop, 110 BPM, G major, acoustic guitar and light drums,
+positive energy building gradually, underscore for product walkthrough
+```
+
+**Technical deep-dive:**
+```
+Minimal ambient electronic, 80 BPM, A minor, soft Rhodes piano and subtle
+bass, contemplative and focused, background music for technical explanation
+```
+
+## Prompting Rules
+
+1. **Always include "background" or "underscore"** — tells the model to stay dynamically even
+2. **Always use instrumental mode** — lyrics compete with narration
+3. **Specify BPM explicitly** — don't rely on genre to set tempo
+4. **Avoid "bright hi-hats" or "prominent vocals"** — high-frequency busy elements compete with speech in the 2-4 kHz intelligibility band
+5. **Include energy direction** — "steady energy" for explainers, "building gradually" for reveals
+
+## Duration Matching
+
+- Generate at the exact video duration when possible
+- For longer videos, generate a track 30-60% of video length and loop with crossfade
+- **Section-mapped scoring** for videos with distinct acts:
+
+| Video Section | Duration | Music Style |
+|--------------|----------|-------------|
+| Intro / hook | 8-10s | Soft, building |
+| Main explanation | 90-120s | Steady, neutral |
+| Key reveal | 20-30s | Intensified, fuller |
+| Outro | 10-15s | Fading, gentle |
+
+Generate each as a separate track and crossfade between them.
+
+## Looping
+
+```bash
+# Loop a track 3x
+ffmpeg -stream_loop 2 -i music.mp3 -c copy music_looped.mp3
+
+# Add crossfade at loop points (2s fade)
+ffmpeg -i music.mp3 -af "afade=t=out:st=28:d=2" part1.mp3
+ffmpeg -i music.mp3 -af "afade=t=in:d=2" part2.mp3
+# Then concat
+```
+
+Better approach: generate at the exact video duration to avoid loop artifacts.
+
+## Integration with Video
+
+- Duck music 18-20 dB below narration during speech
+- Cut 2-4 kHz on the music bed to clear speech intelligibility band
+- Test on phone speakers — if narration disappears behind music, duck more
+- One track per video — avoid switching styles mid-video unless clear narrative shift
+- Music should start at video start and fade out 2-3 seconds before end
+
+---
+
+## Kolbo MCP Integration
+
+| Task | Kolbo MCP Tool | Notes |
+|------|---------------|-------|
+| Generate music | `generate_music` | Use prompt structure above |
+| Instrumental | `generate_music` instrumental=true | Always for video background |
+| With lyrics | `generate_music` lyrics="..." | Pass actual lyric text |
+| Discover models | `list_models` type="music" | Check available music models |
+| Sound effects | `generate_sound` | For whooshes, impacts, ambience |
+
+**Workflow:**
+1. `list_models` type="music" → pick model or auto-select
+2. Write prompt using the BPM/key/mood tables above
+3. `generate_music` with `instrumental: true`, style tags, duration
+4. Download the result and mix with narration using FFmpeg (see `sound-design` skill)
+
+---
+
+## Local / Free Options
+
+> **IMPORTANT:** Always use Kolbo MCP `generate_music` by default. Only mention these if the user explicitly asks for free alternatives. Confirm before installing anything.
+
+**Free music libraries (no install, browser-based):**
+- Pixabay Music — free, no attribution required
+- Free Music Archive — CC-licensed
+- Incompetech (Kevin MacLeod) — CC-BY, huge catalog
+
+**Local generation:** If the user has a GPU (8GB+) and explicitly asks, `MusicGen` by Meta (`pip install audiocraft`) can generate music locally. Confirm before installing.

package/skills/production-review/SKILL.md

@@ -0,0 +1,152 @@
+---
+name: production-review
+description: >
+  Self-review quality gates for video production: post-render verification protocol, pre-delivery
+  checklist, audio verification, visual inspection, severity classification (critical/suggestion/nitpick),
+  review workflow. Use after completing any production stage to verify quality before delivery.
+  Keywords: review, quality, verification, checklist, render, audio check, video check, delivery,
+  QA, quality gate, self-review, post-render
+---
+
+# Production Review — Quality Gates
+
+## When to Use
+
+After completing any major production stage — especially after rendering, before delivering to the user. Read this skill and run through the relevant checklist.
+
+## Severity Levels
+
+| Severity | Definition | Action |
+|----------|-----------|--------|
+| **CRITICAL** | Breaks the output, incomplete, or dangerously wrong | Must fix. Blocks delivery. |
+| **SUGGESTION** | Improves quality significantly but doesn't block | Note it, fix if time allows |
+| **NITPICK** | Nice-to-have polish | Log it, move on |
+
+## Decision Flow
+
+1. Run the relevant checklist below
+2. Count critical findings
+3. **0 critical** → PASS (note suggestions)
+4. **1+ critical** → REVISE (max 2 revision rounds)
+5. After 2 rounds, still critical → PASS_WITH_WARNINGS (inform user of known issues)
+
+---
+
+## Post-Render Verification (Video)
+
+### Step 1: Probe the Output (GATE — blocks all other steps)
+```bash
+ffprobe -v quiet -print_format json -show_format -show_streams rendered_video.mp4
+```
+
+Verify ALL of:
+- [ ] Video stream exists with correct resolution and FPS
+- [ ] **Audio stream exists** — if missing, STOP. Fix audio config, re-render
+- [ ] Duration within +/-5% of target
+- [ ] File size is reasonable (not 0 bytes, not suspiciously small)
+
+**If audio stream is missing, do NOT proceed.** Most common cause: audio sources mixed externally but never embedded in the composition.
+
+### Step 2: Extract Review Frames
+Sample frames at scene midpoints and visually inspect:
+```bash
+ffmpeg -i rendered_video.mp4 -vf "fps=1/5" frame_%04d.png
+```
+- [ ] No visual artifacts or glitches
+- [ ] Text overlays readable and within safe zones
+- [ ] Color grade consistent across scenes
+- [ ] No black frames or flash frames at cuts
+
+### Step 3: Audio Verification
+- [ ] Play back and confirm narration is audible over music
+- [ ] No audio pops or clicks at cut points
+- [ ] Music volume appropriate (18-20 dB below dialogue)
+- [ ] Audio loudness within platform target (-14 LUFS for social)
+
+### Step 4: Present Review to User
+Structured summary with: file stats, audio verification, visual findings, caption status.
+
+---
+
+## Pre-Delivery Checklist by Content Type
+
+### Explainer Video
+- [ ] Hook lands in first 3 seconds
+- [ ] Core concept clearly explained (the "aha" moment)
+- [ ] Captions present and synced
+- [ ] Background music doesn't overpower narration
+- [ ] Duration matches target (+/-10%)
+- [ ] Output plays correctly on target platform
+
+### Short-Form (TikTok/Reels/Shorts)
+- [ ] 9:16 aspect ratio, 1080x1920
+- [ ] Important content within safe zones (900x1400)
+- [ ] Hook in first 1-2 seconds
+- [ ] Captions mandatory (85% watch muted)
+- [ ] File size under platform limit
+- [ ] H.264 High Profile, 8+ Mbps
+
+### Talking Head
+- [ ] Filler words removed
+- [ ] No awkward jump cuts (covered by B-roll or transition)
+- [ ] Speaker's face never covered by overlays
+- [ ] Audio clean — no background noise
+- [ ] Eye-level framing maintained
+
+### Music/Audio
+- [ ] Correct duration
+- [ ] Instrumental if for background use
+- [ ] BPM matches content energy
+- [ ] No clipping or distortion
+- [ ] Loudness normalized to target
+
+---
+
+## Remotion-Specific Verification
+
+Before declaring a Remotion render complete:
+
+- [ ] Run `composition_validator` before rendering
+- [ ] All `staticFile()` references resolve to existing assets
+- [ ] Composition duration matches sum of scene durations minus transition overlaps
+- [ ] No CSS animations used (must use `useCurrentFrame()` + `interpolate()`)
+- [ ] No Tailwind `animate-*` classes (break frame-based rendering)
+- [ ] `interpolate()` calls use `extrapolateLeft: 'clamp', extrapolateRight: 'clamp'`
+- [ ] Audio layers in sync with visual scenes
+- [ ] Theme colors match the active style
+- [ ] Text scenes use Remotion components, NOT AI-generated images with text
+
+## Review Log Format
+
+When logging a review finding:
+```
+[SEVERITY] Finding description
+  - What: specific issue observed
+  - Where: timestamp or scene reference
+  - Fix: recommended action
+```
+
+---
+
+## Kolbo MCP Integration
+
+Use these tools during review:
+
+| Review Step | Kolbo MCP Tool | What to Check |
+|-------------|---------------|---------------|
+| Audio verification | `transcribe_audio` | Transcribe the rendered video — if 0 words, audio is silent |
+| Visual analysis | `chat_send_message` + Gemini | "Review this video for quality issues" |
+| Credit check | `check_credits` | Verify budget before re-renders |
+
+**Post-render verification with Kolbo:**
+1. `ffprobe` the output (always first — check streams exist)
+2. `transcribe_audio` the rendered video → compare word count to script
+3. If word count < 80% of script → audio is cut off → investigate
+4. `chat_send_message` with Gemini + video URL → visual quality review
+5. Present structured findings to user
+
+**Re-generation workflow (if review finds critical issues):**
+1. Identify the failed asset (video clip, audio, image)
+2. Re-generate with adjusted prompt via the appropriate Kolbo MCP tool
+3. Re-compose with FFmpeg or Remotion
+4. Run review again (max 2 revision rounds)

package/skills/short-form-video/SKILL.md

@@ -0,0 +1,168 @@
+---
+name: short-form-video
+description: >
+  Short-form video optimization for TikTok, Instagram Reels, YouTube Shorts, and Facebook Reels.
+  Platform safe zones, upload specs, hook techniques, pacing rules, duration strategy, retention
+  benchmarks, caption requirements. Use when creating vertical video content or optimizing for
+  social platforms.
+  Keywords: tiktok, reels, shorts, vertical video, 9:16, hook, retention, pacing, safe zone,
+  caption, short form, social media, viral
+---
+
+# Short-Form Video (TikTok / Reels / Shorts)
+
+## Quick Reference
+
+```
+ASPECT RATIO:     9:16 vertical (1080x1920)
+SAFE ZONE:        900x1400px centered (universal cross-platform)
+DURATION:         15s (highest completion) | 30s (best engagement) | 60s (most flexible)
+HOOK:             First 1-2 seconds — visual or text pattern interrupt
+CAPTIONS:         Mandatory (85% watch muted on mobile)
+TEXT SIZE:         42px+ minimum, bold sans-serif
+PACING:           Visual change every 1-3 seconds
+TARGET LUFS:      -14 LUFS, true peak -1 dBTP
+MUSIC:            120-140 BPM for energetic, 90-110 for explainers
+CODEC:            H.264 High Profile, 8-15 Mbps VBR
+```
+
+## Platform Safe Zones (1080x1920)
+
+| Platform | Safe Zone | Top Dead | Bottom Dead | Right Dead |
+|----------|-----------|----------|-------------|------------|
+| TikTok | 900x1492 | 108px | 320px | 120px |
+| Instagram Reels | 996x1400 | 210px | 310px | 84px |
+| YouTube Shorts | 984x1500 | 120px | 300px | 96px |
+| Facebook Reels | 1080x1520 | 100px | 300px | 60px |
+
+**Universal safe zone: 900x1400px centered** — works across all platforms.
+
+**Bottom dead zones are critical** — platform UI (comments, share, captions) covers the bottom 300-320px. Never put important content there.
+
+## Duration Strategy
+
+| Duration | Avg Completion | Best For |
+|----------|---------------|----------|
+| 0-15s | 92% | Single fact, quick tip, visual gag |
+| 16-30s | 84% | One concept explained, before/after |
+| 31-60s | 68% | Mini tutorial, step-by-step, story arc |
+| 60s+ | 48% | Deep explainer (only with strong retention structure) |
+
+**Platform sweet spots:**
+- TikTok: 21-34s for completion; 60-180s for maximum total watch time
+- Reels: 15-30s for viral reach; 60-90s for highest engagement
+- Shorts: Bimodal — ~13s OR full 60s
+
+**Key formula:** A 45s video with 70% completion (31.5s watch time) outperforms a 15s video with 40% completion (6s). Total watch time is what the algorithm rewards.
+
+## The 1-Second Hook
+
+70%+ of TikTok users decide to scroll or stay within 3 seconds (average decision: 1.7s).
+
+### 3-Second Retention Impact
+
+| 3-Second Retention | Algorithmic Effect | View Multiplier |
+|-------------------|-------------------|-----------------|
+| Below 60% | Minimal promotion | 1.0x |
+| 60-70% | Average distribution | 1.6x |
+| 70-85% | Optimal reach | 2.2x |
+| 85%+ | Viral potential | 2.8x |
+
+### Hook Techniques
+
+| Technique | Example | When to Use |
+|-----------|---------|-------------|
+| **Bold text on screen** | "STOP doing this..." (frame 1) | Always — works even muted |
+| **Pattern interrupt** | Unexpected visual, jump cut, color flash | Attention-grabbing |
+| **Question** | "Why does X happen?" (text + voiceover) | Educational |
+| **Result first** | Show finished result, then explain how | Tutorial/how-to |
+| **Controversy** | "Everyone gets this wrong" | Engagement bait |
+
+### Hook Rules
+
+1. **Frame 1 must have visual interest** — no blank intros, no logos, no "hey guys"
+2. **Text appears in the first 0.5 seconds** — viewers scan text before listening
+3. **Voice starts immediately** — no silent buildup
+4. **Movement in frame 1** — static opening frames get scrolled past
+
+## Pacing Rules
+
+- Visual change every **1-3 seconds** minimum
+- New information every **3-5 seconds**
+- No static shot longer than **2 seconds** without text overlay or motion
+- Scene transitions should be **hard cuts** (no slow fades on short-form)
+
+## Retention Checkpoints
+
+| Timestamp | Target Retention |
+|-----------|-----------------|
+| 3 seconds | 70%+ |
+| 15 seconds | 60%+ |
+| 30 seconds | 50%+ |
+
+## Upload Specs
+
+```
+CODEC:       H.264 High Profile, Level 4.2
+BITRATE:     8-15 Mbps VBR (below 5 Mbps triggers quality downgrade)
+FORMAT:      .mp4 preferred
+MAX SIZE:    500 MB (desktop), 287.6 MB (iOS), 72 MB (Android)
+```
+
+## Caption Requirements
+
+- **85% of social video is watched on mute** — captions are mandatory
+- Max 3-4 words per cue on vertical (narrow screen)
+- Max 20 characters per line
+- 42px+ minimum font size
+- Bold sans-serif font (Arial, Inter, Montserrat)
+- Thick outline (3px) for readability on varied backgrounds
+- Position in bottom 20% but above the platform dead zone
+
+## 9:16 Conversion (from 16:9 source)
+
+Blurred background + centered content — never crop the original:
+
+```bash
+ffmpeg -i input.mp4 -filter_complex \
+  "[0:v]split[bg][fg]; \
+   [bg]scale=1080:1920:force_original_aspect_ratio=increase, \
+   crop=1080:1920,gblur=sigma=40[blurred]; \
+   [fg]scale=1080:1920:force_original_aspect_ratio=decrease, \
+   pad=1080:1920:(ow-iw)/2:(oh-ih)/2:color=black@0[front]; \
+   [blurred][front]overlay=0:0" \
+  -c:v libx264 -crf 18 -c:a aac output_vertical.mp4
+```
+
+---
+
+## Kolbo MCP Integration
+
+| Task | Kolbo MCP Tool | Notes |
+|------|---------------|-------|
+| Generate vertical video | `generate_video` | Specify "9:16 vertical" in prompt |
+| Image-to-video hook | `generate_video_from_image` | Animate a striking frame for the hook |
+| Batch clips from long-form | `generate_creative_director` | Extract highlights |
+| Add captions | `transcribe_audio` | Get word-level SRT, then burn-in with FFmpeg |
+| Background music | `generate_music` | 120-140 BPM for energetic, instrumental=true |
+| Sound effects | `generate_sound` | Whooshes, pops for transitions |
+| Style consistency | `create_visual_dna` | Same look across a series |
+
+**Short-form production workflow:**
+1. Script using the `storytelling` skill (hook → content → close)
+2. `generate_speech` → narration
+3. `generate_video` or `generate_video_from_image` → visual clips
+4. `generate_music` → background track (120-140 BPM, instrumental)
+5. `transcribe_audio` → get word-level SRT for captions
+6. FFmpeg: compose 9:16 video + burn-in captions + mix audio
+7. Review with `production-review` skill checklist
+
+---
+
+## Local / Free Options
+
+> **IMPORTANT:** Always use Kolbo MCP tools by default. FFmpeg is the only tool safe to use without asking — it's standard software. For anything else, confirm with the user first.
+
+**FFmpeg (safe, standard):** Handles 9:16 conversion, caption burn-in, audio mixing, silence removal — all commands in this skill and the `ffmpeg-patterns` skill.
+
+**Transcription:** Kolbo's `transcribe_audio` is easiest. If the user explicitly wants offline transcription, `faster-whisper` runs on CPU with no GPU needed (`pip install faster-whisper`) — but confirm before installing.

package/skills/sound-design/SKILL.md

@@ -0,0 +1,154 @@
+---
+name: sound-design
+description: >
+  Audio production rules for video: dialogue levels, music ducking, SFX placement and timing,
+  BPM selection by content type, platform loudness targets (LUFS), voice EQ and compression,
+  audio ducking levels. Use when mixing audio for video, choosing background music, or placing
+  sound effects.
+  Keywords: audio, sound design, ducking, LUFS, loudness, music, sfx, sound effects, mixing,
+  dialogue, voice, EQ, compression, BPM, volume, audio levels
+---
+
+# Sound Design for Video Production
+
+## Quick Reference
+
+```
+DIALOGUE:       -12 dB peak  |  -16 to -14 LUFS integrated
+MUSIC BED:      -30 to -20 dB (18-20 dB below dialogue)
+SFX:            -18 to -12 dB (6 dB below dialogue minimum)
+WHOOSH TIMING:  Start 10-20ms before visual, duration 400-500ms
+MUSIC BPM:      Calm 60-80 | Standard 90-110 | Upbeat 120-140
+TRUE PEAK:      Never exceed -1.5 dBTP
+VOICE EQ:       HPF 80Hz, cut 500Hz, boost 2-5kHz, cut 6-8kHz
+VOICE COMP:     3:1 ratio, 1-5ms attack, 10-20ms release
+TARGET LUFS:    -14 LUFS (YouTube/TikTok/IG) | -16 LUFS (podcasts)
+```
+
+## Audio Ducking Levels
+
+| Element | Peak Level | Notes |
+|---------|-----------|-------|
+| Dialogue / Narration | -6 dB to -12 dB | Primary element |
+| Background music (during speech) | -18 dB to -20 dB | 18-20 dB below dialogue |
+| Sound effects | -12 dB to -18 dB | Between dialogue and music |
+| Final mix | -10 dB to -20 dB | Never exceed 0 dB |
+
+**Ducking rules:**
+- W3C accessibility: music must be **20 dB lower** than foreground speech
+- BBC guideline: lower music by an additional **4 dB** from where you think it sounds right
+- Duck music **6-12 dB** when narration is active
+- EQ trick: cut **2-4 kHz** on background music to clear the speech intelligibility band
+- When testing, adjust in **1 dB increments** from a -20 dB baseline upward
+
+## Music Selection by Content Type
+
+| Content Type | BPM Range | Mood |
+|-------------|-----------|------|
+| Calm explainer / tutorial | 60-80 | Contemplative, focused |
+| Corporate / testimonial | 60-100 | Professional, calm |
+| Standard explainer | 90-110 | Steady, engaging |
+| Upbeat promo | 110-130 | Enthusiastic |
+| High-energy / demo | 120-140 | Exciting, dynamic |
+| Action / fast-paced | 140-200 | Adrenaline |
+
+**Genre recommendations for explainers:**
+- Lo-fi (steady, non-distracting, modern feel)
+- Ambient (atmospheric, stays in background)
+- Light acoustic guitar instrumentals (warm, approachable)
+- Inspiring soundtrack / cinematic light (builds emotion without overwhelming)
+
+**Key rules:**
+- Always use **instrumental** tracks when voiceover is present
+- Choose dynamically **even** tracks — avoid dramatic crescendos or beat drops
+- Match energy to the content: upbeat for "exciting new concept," gentle for serious topics
+
+## Sound Effects (SFX) Placement
+
+| SFX Type | Use Case | Duration | Level |
+|----------|----------|----------|-------|
+| Whoosh / Swish | Scene transitions | 400-500ms | -18 to -12 dB |
+| Pop / Pluck | Text appearing, bullet points | <200ms | -15 to -12 dB |
+| Click / Tap | UI interactions | <100ms | -20 to -15 dB |
+| Riser / Swell | Building to a reveal | 1-3s | -18 to -12 dB |
+| Impact / Hit | Key reveal, stat | <300ms | -12 to -6 dB |
+| Subtle whoosh | Element sliding in/out | 200-400ms | -20 to -15 dB |
+
+### Timing Rules
+- Start whoosh **10-20ms before** the visual transition (brain processes audio faster)
+- Peak of whoosh energy = **moment of greatest visual change**
+- Fine-tune in **1-frame increments** for sync
+- When stacking whooshes, keep them in different frequency bands
+
+## Platform Loudness Targets
+
+| Platform | Integrated LUFS | True Peak |
+|----------|----------------|-----------|
+| YouTube | -14 LUFS | -1 dBTP |
+| TikTok | -14 LUFS | -1 dBTP |
+| Instagram Reels | -14 LUFS | -1 dBTP |
+| Spotify (podcast) | -14 LUFS | -1 dBTP |
+| Apple Podcasts | -16 LUFS | -1 dBTP |
+| Broadcast TV | -24 LUFS | -2 dBTP |
+
+## Voice Processing Chain
+
+Apply in this order:
+1. **High-pass filter** at 80 Hz (removes rumble)
+2. **Cut 500 Hz** by 2-3 dB (removes muddiness)
+3. **Boost 2-5 kHz** by 2-3 dB (presence and clarity)
+4. **Cut 6-8 kHz** by 1-2 dB (reduces sibilance)
+5. **Compress** at 3:1 ratio, 1-5ms attack, 10-20ms release
+6. **Normalize** to target LUFS
+
+## FFmpeg Audio Commands
+
+### Loudness Normalization
+```bash
+ffmpeg -i input.mp4 -af loudnorm=I=-14:LRA=11:TP=-1 -c:v copy output.mp4
+```
+
+### Audio Ducking with Sidechain
+```bash
+ffmpeg -i narration.wav -i music.wav -filter_complex \
+  "[1:a]asplit=2[music1][music2]; \
+   [0:a][music2]sidechaincompress=threshold=0.02:ratio=9:attack=200:release=500[ducked]; \
+   [music1][ducked]amix=inputs=2:weights='1 0.15'" \
+  -c:a aac output.m4a
+```
+
+### Measure Loudness
+```bash
+ffmpeg -i input.mp4 -af loudnorm=print_format=json -f null - 2>&1 | grep -A 20 "Parsed_loudnorm"
+```
+
+---
+
+## Kolbo MCP Integration
+
+| Task | Kolbo MCP Tool | Notes |
+|------|---------------|-------|
+| Generate narration | `generate_speech` | See `list_voices` for voice options |
+| Generate music | `generate_music` | Use BPM tables above, always instrumental=true |
+| Generate SFX | `generate_sound` | Describe physically: "door slam in stone hallway" |
+| Transcribe audio | `transcribe_audio` | Word-level timestamps for sync |
+| Voice discovery | `list_voices` | Filter by language, gender, provider |
+
+**Full audio production workflow:**
+1. `generate_speech` → narration track
+2. `generate_music` instrumental=true → background music
+3. `generate_sound` → individual SFX (whooshes, impacts)
+4. Mix with FFmpeg using the ducking commands above
+5. Normalize to -14 LUFS for social platforms
+
+---
+
+## Local / Free Options
+
+> **IMPORTANT:** Always use Kolbo MCP tools by default. Only mention these if the user explicitly asks for free/offline options. Always confirm before installing anything.
+
+**TTS:** `edge-tts` (free Microsoft voices, no GPU, `pip install edge-tts`) or `piper-tts` (fully offline, CPU-only). Both are safe, lightweight installs.
+
+**SFX libraries (no install needed):** Freesound.org, Pixabay Sound Effects, BBC Sound Effects — all free, browser-based.
+
+**FFmpeg** is the only tool you should use without asking — it's standard and safe. All the mixing/ducking/normalization commands in this skill use FFmpeg.