Hands

id = "clip"
name = "Clip Hand"
description = "YouTube to vertical shorts pipeline with AI voice-over"
category = "content"
icon = "🎬"

# Tools this hand needs access to
tools = [
    "shell_exec",
    "file_read",
    "file_write",
    "file_list",
    "memory_store",
    "memory_recall",
    "web_fetch",
]

# Skill allowlist (empty = all skills available)
skills = ["ffmpeg-expert", "audio-processing"]

# MCP server allowlist (empty = all connected MCP servers)
mcp_servers = []

# Requirements that must be satisfied before activation
[[requires]]
key = "ffmpeg"
label = "FFmpeg must be installed"
requirement_type = "binary"
check_value = "ffmpeg"
description = "FFmpeg is the core video processing engine for Clip."

[requires.install]
macos = "brew install ffmpeg"
windows = "winget install Gyan.FFmpeg"
linux_apt = "sudo apt install ffmpeg"
linux_dnf = "sudo dnf install ffmpeg-free"
linux_pacman = "sudo pacman -S ffmpeg"
manual_url = "https://ffmpeg.org/download.html"
estimated_time = "2-5 min"

[[requires]]
key = "yt-dlp"
label = "yt-dlp must be installed"
requirement_type = "binary"
check_value = "yt-dlp"

[requires.install]
pip = "pip install yt-dlp"
macos = "brew install yt-dlp"
windows = "winget install yt-dlp.yt-dlp"
linux_apt = "sudo apt install yt-dlp"

[[requires]]
key = "GROQ_API_KEY"
label = "Groq API Key"
requirement_type = "api_key"
check_value = "GROQ_API_KEY"
description = "Groq powers the AI transcription engine."

[requires.install]
signup_url = "https://console.groq.com/keys"
docs_url = "https://console.groq.com/docs/quickstart"
env_example = "GROQ_API_KEY=gsk_..."
estimated_time = "5 min"
steps = [
    "Go to console.groq.com and sign up",
    "Navigate to API Keys section",
    "Generate a new API key",
    "Set GROQ_API_KEY environment variable",
]

# Configurable settings (shown in activation modal)
[[settings]]
key = "stt_provider"
label = "Speech-to-Text Provider"
description = "Which transcription engine to use"
setting_type = "select"
default = "auto"

[[settings.options]]
value = "auto"
label = "Auto-detect (tries all available)"

[[settings.options]]
value = "groq"
label = "Groq Whisper (fast, accurate)"
provider_env = "GROQ_API_KEY"

[[settings.options]]
value = "openai"
label = "OpenAI Whisper (most accurate)"
provider_env = "OPENAI_API_KEY"

[[settings.options]]
value = "deepgram"
label = "Deepgram (real-time capable)"
provider_env = "DEEPGRAM_API_KEY"

[[settings.options]]
value = "local"
label = "Local Whisper (no API key needed)"
binary = "whisper"

[[settings]]
key = "output_format"
label = "Output Format"
description = "Where to save the generated clips"
setting_type = "select"
default = "local"

[[settings.options]]
value = "local"
label = "Save locally"

[[settings.options]]
value = "telegram"
label = "Send to Telegram"

[[settings.options]]
value = "whatsapp"
label = "Send to WhatsApp"

[[settings]]
key = "enable_tts"
label = "Enable AI Voice-Over"
description = "Add AI-generated voice-over to clips"
setting_type = "toggle"
default = "false"

[[settings]]
key = "custom_outro"
label = "Custom Outro Text"
description = "Text to display at end of clips (leave empty for none)"
setting_type = "text"
default = ""

# Agent configuration
[agent]
name = "clip-hand"
description = "Autonomous YouTube clip generator"
module = "builtin:chat"
provider = "anthropic"
model = "claude-sonnet-4-20250514"
max_tokens = 8192
temperature = 0.7
system_prompt = '''
You are Clip Hand, an autonomous video processing agent...

[500+ word operational playbook with 8-phase pipeline]

Phase 1: Download
Phase 2: Transcribe
Phase 3: Identify highlights
Phase 4: Extract clips
Phase 5: Add captions
Phase 6: Generate thumbnails
Phase 7: (Optional) Add voice-over
Phase 8: Deliver
'''

# Dashboard metrics
[dashboard]
metrics = [
    { label = "Videos Processed", memory_key = "videos_processed", format = "number" },
    { label = "Clips Generated", memory_key = "clips_generated", format = "number" },
    { label = "Total Duration", memory_key = "total_duration_seconds", format = "duration" },
    { label = "Processing Time", memory_key = "avg_processing_seconds", format = "duration" },
]