A Claude Code skill that drives the agent-media CLI to generate AI UGC videos — Selfie clips, reusable characters, burned-in subtitles — from natural-language prompts inside Claude Code, Cursor, Continue, or any MCP-aware AI client.

# 1. Install the CLI + log in
npm install -g agent-media-cli@latest
agent-media login

# 2. Add the skill
claude skills add github:gitroomhq/agent-media

Restart Claude Code, then describe what you want — the skill walks you through 4 gates (script, character, director's brief, duration), runs the CLI, and returns the mp4 URL.

These use a hosted HTTP MCP endpoint:

1. Settings → Integrations → Add custom MCP server
2. URL: https://api.agent-media.ai/mcp
3. Auth header: Authorization: Bearer <your-ma_xxx-key>

Tools create_selfie, create_character, create_subtitle show up in the picker.

Add to ~/.cursor/mcp.json (or your client's equivalent):

{
  "mcpServers": {
    "agent-media": {
      "command": "npx",
      "args": ["-y", "@agentmedia/mcp-server"],
      "env": { "AGENT_MEDIA_API_KEY": "<your-ma_xxx-key>" }
    }
  }
}

agent-media skill update       # pulls the latest SKILL.md + reference/*
agent-media skill status       # local vs remote version

Every CLI invocation runs a once-per-day background check and prints a one-line nudge when a newer skill version is available. Opt-in silent auto-update with AGENT_MEDIA_AUTO_UPDATE_SKILL=1; opt-out with AGENT_MEDIA_SKIP_SKILL_CHECK=1.

SKILL.md                         # ~4 KB index + hard-gate directive
reference/
  conversation-flow.md           # MUST READ — the 4 gates protocol
  presets.md                     # 20 shot presets + "best for" hints
  vibes.md                       # 5 vibes (excited, calm, sassy, …)
  subtitle-styles.md             # 17 subtitle styles
  realism-rubric.md              # 9-point visual-quality guard
  errors.md                      # common error codes + fixes
  generators/
    selfie.md                    # talking-head pipeline deep dive
    character_create.md          # persisted reusable character
    subtitle.md                  # burn subs onto any video
docs/
  api-reference.md               # auto-generated REST reference

Pricing lives at https://agent-media.ai/pricing. The API debits internally — agents and clients should not surface credit numbers or USD to end users.

• agent-media-cli — the CLI itself
• @agentmedia/mcp-server — local stdio MCP

• Public install page: https://agent-media.ai/skill
• API reference: docs/api-reference.md
• Pricing: https://agent-media.ai/pricing

Apache-2.0 · 2026 agent-media contributors