@kolbo/kolbo-code-linux-arm64-musl 1.1.74 → 2.0.0

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

@@ -1,168 +0,0 @@
----
-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

@@ -1,154 +0,0 @@
----
-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.

package/skills/storytelling/SKILL.md

@@ -1,139 +0,0 @@
----
-name: storytelling
-description: >
-  Narrative structure and storytelling for video content. Explainer arc templates, hook types,
-  the 30-second retention rule, pacing by duration, the "but-therefore" method, concept
-  introduction patterns. Use when scripting explainer videos, educational content, or any
-  narrative-driven video.
-  Keywords: storytelling, narrative, script, explainer, hook, arc, structure, pacing, retention,
-  educational, concept, story, writing, script structure
----
-
-# Storytelling & Narrative Structure for Video
-
-## The Explainer Arc Template (3 minutes)
-
-Scale proportionally for other lengths.
-
-```
-[0:00 - 0:08]  HOOK
-               Pattern interrupt or counterintuitive claim. 1-2 sentences max.
-               Visual: striking image or animation that creates curiosity.
-
-[0:08 - 0:30]  TENSION / INFORMATION GAP
-               "Here's what most people think... but that's not quite right."
-               Establish stakes: why should I care?
-
-[0:30 - 0:50]  CONCEPT 1 (Foundation)
-               Simplest building block needed. ONE idea, ONE visual.
-               End with a "but" or "therefore" transition.
-
-[0:50 - 1:15]  CONCEPT 2 (Complication)
-               Build on Concept 1. Introduce the wrinkle.
-               Visual: transform/evolve the previous visual.
-
-[1:15 - 1:20]  PALETTE CLEANSER
-               Brief pause, visual gag, or "let that sink in" moment.
-               Gives working memory a beat to consolidate.
-
-[1:20 - 1:50]  CONCEPT 3 (Key Insight)
-               The "aha" moment. Core of the video.
-               1-3 seconds of deliberate silence after the reveal.
-               Visual: the most polished animation in the video.
-
-[1:50 - 2:20]  PROOF / EXAMPLE
-               Concrete demonstration: "Watch what happens when..."
-               Show the insight working in a specific case.
-
-[2:20 - 2:45]  IMPLICATIONS / "SO WHAT?"
-               Connect back to the real world. "This means that..."
-               Scale from specific back to general.
-
-[2:45 - 3:00]  REFRAME + CLOSE
-               Callback to the hook. Restate core insight in one sentence.
-               Optional: open a new curiosity gap.
-```
-
-## Scaling by Duration
-
-| Length | Concepts | Hook | Tension | Core | Proof | Close |
-|--------|----------|------|---------|------|-------|-------|
-| 1 min | 1-2 | 5s | 10s | 30s | 10s | 5s |
-| 2 min | 2-3 | 8s | 15s | 60s | 25s | 12s |
-| 3 min | 3-5 | 8s | 22s | 100s | 30s | 15s |
-| 5 min | 5-8 | 10s | 30s | 180s | 50s | 20s |
-
-## Hook Types
-
-| Type | Pattern | Best For |
-|------|---------|----------|
-| **Contrarian** | "Everything you've been told about X is wrong." | Science/myth-busting |
-| **Outcome** | "By the end of this video, you'll understand X." | Math/concept explainers |
-| **Mystery** | "In 1987, something impossible happened..." | Story-driven content |
-| **Stakes** | "This one mistake costs people X every year." | Practical/how-to |
-
-## The 30-Second Rule
-
-50% of viewer drop-off happens in the first 30 seconds. The hook + tension setup MUST be complete by second 30. Retention curves that survive the 30-second cliff typically retain 40-60% through the full video.
-
-## The "But-Therefore" Method
-
-Never connect sections with "and then." Always use **"but"** or **"therefore."**
-
-**Bad:** "Atoms have electrons, AND THEN those electrons have energy levels, AND THEN..."
-
-**Good:** "Atoms have electrons. BUT those electrons can only exist at specific energy levels. THEREFORE, when they jump between levels, they release light at exact frequencies."
-
-Each "but" creates tension. Each "therefore" resolves it. This is the engine of narrative momentum.
-
-## Concept Introduction Pattern
-
-For each new concept in the video:
-
-1. **Name it** — give the concept a label the viewer can hold onto
-2. **Show it** — visual representation (never just explain with words)
-3. **Contrast it** — "unlike X, this works by..."
-4. **Apply it** — concrete example in the real world
-5. **Connect it** — link to the previous concept with "but" or "therefore"
-
-## Pacing by Content Energy
-
-| Energy Level | Pacing | Visual Change Rate |
-|-------------|--------|-------------------|
-| High (promo, action) | Fast cuts, 1-2s per shot | Every 1-2 seconds |
-| Medium (tutorial, explainer) | Balanced, 3-5s per shot | Every 3-4 seconds |
-| Low (meditation, documentary) | Let scenes breathe, 5-10s | Every 5-8 seconds |
-
-## Common Mistakes
-
-- **Info dump at the start** — frontload curiosity, not information
-- **No stakes** — "here's a cool fact" vs "this changes how you should think about X"
-- **Too many concepts** — one concept per minute is the maximum for retention
-- **Missing the "aha"** — every video needs ONE clear revelation moment
-- **Symmetric structure** — the most important concept should be at 60-70% through the video, not in the middle
-- **No callback** — the close should reference the hook, creating a satisfying loop
-
----
-
-## Kolbo MCP Integration
-
-Use storytelling structure to guide Kolbo generation workflows:
-
-**Scripted Explainer Workflow:**
-1. Write script using the arc template above
-2. `generate_speech` → narrate each section
-3. `generate_image` or `generate_video` per scene (with visual direction from script)
-4. `generate_music` → background track matching the energy arc
-5. Compose in Remotion or FFmpeg following the timing structure
-6. `transcribe_audio` → generate captions for accessibility
-
-**AI-Assisted Scripting:**
-Use `chat_send_message` with a video-capable model to brainstorm scripts. Feed the arc template as context and ask the AI to fill in each section for your topic.
-
-**Creative Director for Visual Storyboarding:**
-`generate_creative_director` with 4-8 scenes mapped to the arc sections:
-- Scene 1: Hook visual
-- Scene 2-3: Concept visuals
-- Scene 4: Key insight / "aha" visual
-- Scene 5-6: Proof / example
-- Scene 7-8: Close / callback