AgentBroko v1.3.0
AI Agent Skills Ecosystem

Empower Your IDE Coding Agent with Video & PDF Skills

Install AgentBroko skills into any workspace. Open your AI editor (Google Antigravity, Cursor, VS Code Cline, Windsurf, Roo Code), prompt your agent in plain English, and watch it generate broadcast videos and 20-page handbooks with zero external API keys.

npx agentbroko init

🚀 The Agent-First Experience

Just like software packages live in node_modules, AgentBroko provisions standard skill contracts in .agents/skills/ so your coding agent knows exactly how to build media for you.

Step 1 • Install
Initialize Skills
Run npx agentbroko init or npx agentbroko add video-forge in your project.
Step 2 • Prompt
Ask Your Agent
In Cursor, Antigravity, or VS Code, tell your agent: "Create a 30s TikTok short for my SaaS launch using Video Forge."
Step 3 • Deliver
Instant Media
Your agent plans the timeline, generates voiceovers, builds SRTs, and outputs final.mp4 or playbook.pdf locally.

1. Workspace Installation & Setup

Add AgentBroko skills to any existing repository or new project:

# 1. Initialize ALL agent skills in your project workspace
npx agentbroko init

# Provisions:
#  .agents/skills/video-forge/SKILL.md  (Video editing skill contract)
#  .agents/skills/pdf-playbook/SKILL.md (Handbook synthesis skill contract)
#  .agents/skills/pdf/SKILL.md          (Offline PDF tools)
#  .cursorrules, CLAUDE.md & .agents/AGENTS.md (IDE Agent instructions + stuck recovery)
# Add only Video Forge skill:
npx agentbroko add video-forge

# Add only PDF Playbook skill:
npx agentbroko add pdf-playbook

# Add only Offline PDF tools:
npx agentbroko add pdf
# Check environment diagnostics for FFmpeg, Python, ReportLab, and TTS
npx agentbroko doctor

# Print full AI coding agent instruction and self-recovery guide
npx agentbroko guide
# Install locally as a development dependency
npm install -D agentbroko
npx agentbroko init

# Or install globally for terminal access
npm install -g agentbroko
# Clone and install locally in editable mode
git clone https://github.com/sajidhossain8272/agentbroko.git
cd agentbroko
pip install -e .

# Initialize skills in current workspace
agentbroko init
Prerequisites: Python 3.10+ and ffmpeg / ffprobe on your PATH for video rendering.

2. How to Prompt Your IDE Coding Agent

Once initialized, open your AI editor (Cursor, Google Antigravity, Cline, Roo Code, Windsurf) and prompt your agent directly:

🎬 Video Forge Agent Prompt Example
"Hey agent, create a 30-second 9:16 vertical TikTok short for my new AI Developer Tool launch. Use Video Forge to write the voiceover script, synthesize speech narration, generate kinetic SRT subtitles, and render the final MP4 video."
✓ Your agent reads .agents/skills/video-forge/SKILL.md, creates project.json, synthesizes narration.wav and subtitles.srt, and renders outputs/final.mp4 automatically.
📄 PDF Playbook Agent Prompt Example
"Agent, generate a complete 20-page developer handbook on 'Building AI Agents with Microservices' for Backend Engineers. Use PDF Playbook skill to structure the chapters, checklists, and compile the final PDF."
✓ Your agent reads .agents/skills/pdf-playbook/SKILL.md, writes a structured 18-chapter blueprint spec.json, and compiles a publication-ready ReportLab PDF.

3. Skill: Video Forge Reference

Local-first video editing, offline speech synthesis, and FFmpeg video compositing:

# 1. Check local tools (FFmpeg, FFprobe, TTS engines)
agentbroko video-forge doctor

# 2. Create a new video project scaffold
agentbroko video-forge init my-video

# 3. Validate project schema without rendering
agentbroko video-forge validate my-video/project.json

# 4. Generate speech narration from a text script (offline TTS)
agentbroko video-forge speak --file my-video/script.txt --output my-video/audio/narration.wav

# 5. Create synchronized SRT captions
agentbroko video-forge captions --file my-video/script.txt --output my-video/captions/subtitles.srt

# 6. Render the final MP4 video
agentbroko video-forge render my-video/project.json
{
  "output": "outputs/final.mp4",
  "title": "My Video",
  "video": { "width": 1080, "height": 1920, "fps": 60 },
  "clips": [
    { "source": "media/clip-01.mp4", "start": 0, "duration": 5, "speed": 1, "volume": 1 }
  ],
  "audio": { "narration": "audio/narration.wav", "music": null, "music_volume": 0.12 },
  "subtitles": "captions/subtitles.srt"
}

4. Skill: PDF Playbook Reference

Publication-grade 20-page developer handbook and technical documentation synthesis via ReportLab:

# Compile PDF from your AI coding agent's structured JSON spec
agentbroko pdf-playbook --spec playbook_spec.json --output my-guide.pdf
# Generate with Google Gemini API
agentbroko pdf-playbook --api-key AIzaSy... --title "AI Engineering Playbook" --output guide.pdf
# Generate 100% offline with local Ollama (run 'ollama run llama3' first)
agentbroko pdf-playbook --provider ollama --output local-guide.pdf

5. Registered Skills Reference

All skills are discoverable from your command line or coding agent context:

Skill / Tool CLI Command Purpose Network
All Skills Init npx agentbroko init Provisions all .agents/skills/ and IDE rules into workspace Offline (0 KB)
Add Single Skill npx agentbroko add <skill> Installs one specific skill (e.g. video-forge, pdf-playbook) Offline (0 KB)
Doctor Check npx agentbroko doctor Verifies FFmpeg, Python, ReportLab, and offline TTS engines Offline (0 KB)
Agent Stuck Guide npx agentbroko guide Prints self-recovery instructions for coding agents Offline (0 KB)
Video Forge agentbroko video-forge Timeline assembly, TTS speech, subtitles, FFmpeg MP4 rendering Offline (0 KB)
PDF Playbook agentbroko pdf-playbook 20-page developer handbook synthesis via ReportLab Offline / AI
PDF Tools agentbroko pdf Offline text extraction, page rendering, metadata inspection Offline (0 KB)

6. 🆘 Agent Stuck & Self-Recovery Protocol

If your AI coding agent runs into issues or fails during execution, follow this deterministic recovery checklist:

Emergency Resolution Checklist
1. Run Doctor: npx agentbroko doctor
2. Missing FFmpeg: Install via winget install Gyan.FFmpeg (Windows), brew install ffmpeg (macOS), or sudo apt install ffmpeg (Linux).
3. Missing ReportLab: Run python -m pip install reportlab.
4. Project Validation Error: Run npx agentbroko video-forge validate project.json and check file existence on disk.
5. Inspect Local Media: Run ffprobe -v error -show_entries stream=width,height,duration <file>.
6. Zero Cloud Leaks: Never send media or sensitive PDFs to external cloud APIs.