# CaptureBeam — agent skill bundle

This bundle teaches an LLM-backed agent how to author and render demo videos
through the CaptureBeam REST API.

## Files

| File | What it is |
|------|-----------|
| `SKILL.md` | The skill itself. Drops into `~/.claude/skills/capturebeam/SKILL.md` for Claude Code, or use as context for any agent runtime. |
| `system-prompt.md` | Drop-in system prompt for OpenAI / Anthropic / generic agent loops. |
| `schema.json` | JSON Schema (draft-07) for `demo.yaml`. Mirrors `GET /api/v1/schema` (live source). |
| `examples/` | Four worked examples covering minimal, onboarding, feature-tour, and Storybook-component flows. |

## Quick start (Claude Code Skills)

```sh
mkdir -p ~/.claude/skills/capturebeam
curl -L https://capturebeam.com/agents/SKILL.md          -o ~/.claude/skills/capturebeam/SKILL.md
curl -L https://capturebeam.com/agents/system-prompt.md  -o ~/.claude/skills/capturebeam/system-prompt.md
curl -L https://capturebeam.com/agents/schema.json       -o ~/.claude/skills/capturebeam/schema.json

mkdir -p ~/.claude/skills/capturebeam/examples
for n in 01-minimal 02-onboarding 03-feature-tour 04-storybook-component; do
  curl -L "https://capturebeam.com/agents/examples/${n}.yaml" \
    -o "~/.claude/skills/capturebeam/examples/${n}.yaml"
done
```

After that, ask Claude Code anything like *"render an onboarding demo for
https://app.acme.com"* and the skill kicks in automatically.

## Quick start (other agent runtimes)

Read `system-prompt.md` and pass it as the system message. Read `schema.json`
and either include it in context or expose it as a tool the agent can fetch.
Use `examples/` to seed few-shot prompting if your agent benefits from
worked examples.

## Live endpoints

The schema in this bundle is a snapshot. The authoritative live version is
always at:

```
GET https://capturebeam.com/api/v1/schema
```

For target discovery the agent must call:

```
POST https://capturebeam.com/api/v1/probe
```

with a Bearer token. See `SKILL.md` for the full contract.