# Slate CLI and agent skill

This page is for coding agents and humans who want Slate to edit a recorded video from a local folder.

## Raw links

- Human docs: https://useslate.app/docs/slate
- Markdown docs: https://useslate.app/docs/slate.md
- Skill entrypoint: https://useslate.app/skills/slate/SKILL.md

## Install the Slate CLI

```sh
curl -fsSL https://useslate.app/api/v1/cli/install | sh
slate version
slate auth login
slate auth status --json
```

## Install the Slate skill

If your agent supports skills.sh, use the Skills CLI from a repo checkout:

```sh
npx skills add ./cli/slate/skill --skill slate --global --agent claude-code --agent codex --yes
```

From the repository root, this also discovers the skill:

```sh
npx skills add . --list --full-depth
```

For GitHub-hosted installs, use the same direct-path shape:

```sh
npx skills add https://github.com/<owner>/<repo>/tree/main/cli/slate/skill --skill slate --global --agent claude-code --agent codex --yes
```

If skills.sh is not available in the agent harness, install the files directly.
Create a skill folder named `slate` in the active agent's skills directory, then fetch these files:

- `SKILL.md`: https://useslate.app/skills/slate/SKILL.md
- `agents/openai.yaml`: https://useslate.app/skills/slate/agents/openai.yaml
- `references/install-and-auth.md`: https://useslate.app/skills/slate/references/install-and-auth.md
- `references/local-link-and-sync.md`: https://useslate.app/skills/slate/references/local-link-and-sync.md
- `references/post-recording-reconciliation.md`: https://useslate.app/skills/slate/references/post-recording-reconciliation.md
- `references/edit-workspace.md`: https://useslate.app/skills/slate/references/edit-workspace.md
- `references/cli-reference.md`: https://useslate.app/skills/slate/references/cli-reference.md

For Codex-style agents, a typical local install looks like this:

```sh
mkdir -p "$HOME/.agents/skills/slate/agents" "$HOME/.agents/skills/slate/references"
curl -fsSL https://useslate.app/skills/slate/SKILL.md -o "$HOME/.agents/skills/slate/SKILL.md"
curl -fsSL https://useslate.app/skills/slate/agents/openai.yaml -o "$HOME/.agents/skills/slate/agents/openai.yaml"
curl -fsSL https://useslate.app/skills/slate/references/install-and-auth.md -o "$HOME/.agents/skills/slate/references/install-and-auth.md"
curl -fsSL https://useslate.app/skills/slate/references/local-link-and-sync.md -o "$HOME/.agents/skills/slate/references/local-link-and-sync.md"
curl -fsSL https://useslate.app/skills/slate/references/post-recording-reconciliation.md -o "$HOME/.agents/skills/slate/references/post-recording-reconciliation.md"
curl -fsSL https://useslate.app/skills/slate/references/edit-workspace.md -o "$HOME/.agents/skills/slate/references/edit-workspace.md"
curl -fsSL https://useslate.app/skills/slate/references/cli-reference.md -o "$HOME/.agents/skills/slate/references/cli-reference.md"
```

If your agent uses a different skill directory, keep the same folder shape:

```text
slate/
  SKILL.md
  agents/openai.yaml
  references/install-and-auth.md
  references/local-link-and-sync.md
  references/post-recording-reconciliation.md
  references/edit-workspace.md
  references/cli-reference.md
```

## Agent startup prompt

```text
Use the Slate skill to sync my newly recorded media, reconcile my Slate script annotations with the real clips, hydrate the edit workspace, and render a draft video.
```

The skill owns the workflow details. The CLI does deterministic work; the agent uses LLM judgment for placeholder-to-clip reconciliation.