> ## Documentation Index
> Fetch the complete documentation index at: https://docs.decktalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent skills

> The six packaged skills that teach a coding agent to write, build and repair a DeckTalk video.

DeckTalk ships six agent skills. A skill is a folder with a `SKILL.md` file, written in the Agent
Skills open format, that a coding agent loads when a task matches its description. The skills turn
the CLI into something an agent can drive on its own, and they carry the rules that a person would
otherwise learn from these docs.

The skills live inside the Python package, so every installation carries the skills that match its
own CLI. `decktalk init` writes them into a new project, and
[Install the skills](/agents/install) covers the folders they land in.

## The six skills

| Skill             | It starts when                                                                                                                                                                                                                                    | It ends with                                                                                                  |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `decktalk-script` | someone asks for a new narrated video, explainer, tutorial, product demo or lesson, adds a section, or changes what the voice says.                                                                                                               | `script.md` written to a time budget, with a table of every spoken phrase and the symbols it stands for.      |
| `decktalk-slide`  | a narrated video needs a new slide or scene, when maths or code has to appear on screen, when a picture must be added to an existing section, or when a reveal is too small, overlapping or off frame.                                            | Markup that obeys the page contract, checked against the PNGs that `decktalk screenshots` writes.             |
| `decktalk-cues`   | a script, a page or a reveal changes, when align reports an unresolved or unknown cue, when a picture appears early, late or not at all, or when a reveal is too small for the checker to see.                                                    | Every `data-cue` matched to `cues.json` in both directions, with the gaps inside their thresholds.            |
| `decktalk-build`  | someone asks to build, render, export, preview or check a narrated video, an explainer, a tutorial or a lesson, or after any edit to script.md, cues.json, decktalk.toml or a deck page.                                                          | A verified build, with the frames shown to you before the work is called done.                                |
| `decktalk-fix`    | preflight, align, record, verify or build exits non-zero with error set to null, when a cue is unresolved or unknown, when a reveal lands off cue or shows no change, when a recording stalls or starts black, or when preflight skips every cue. | The smallest edit that clears the finding, and the failing command run again with `--only`.                   |
| `decktalk-revise` | someone says a demo, tutorial, explainer or lesson is out of date, asks for this week's update, or names a release that changed what the video claims.                                                                                            | The fewest edits, a build of the changed sections alone, and a change note with the sections and the dollars. |

## What the skills will not do on their own

The skills are written so that an agent cannot spend your money or hide a failure.

* A voiced run stops and asks. `decktalk-build` reports the sections a voiced run would voice, their
  characters, the dollars and the host, and then waits for your approval.
* No skill passes `--force`, `--exit-zero` or an `--allow-` flag, and no skill turns `verify` off.
* No skill edits the `[voice]` table without asking.
* `decktalk-fix` reads `findings.items[]` and fixes the project. On exit code 3 it stops and reports
  the error to you, because exit code 3 means DeckTalk itself could not run.

No portable field in the skill format stops a model from starting a skill on its own, so these
guards live in the skill text and in the CLI rather than in front matter.

## The other two agent surfaces

A skill is not the only thing to hand an agent.

* [The reference card](/reference/card) puts every file, command, rule and exit code on one page.
  Hand it to an agent that has no skills loaded.
* [`llms.txt`](https://docs.decktalk.ai/llms.txt) indexes every page on this site, and
  [`llms-full.txt`](https://docs.decktalk.ai/llms-full.txt) is the whole site as one file. Hand
  those to an agent that can fetch a URL.
* [The JSON contract](/agents/json) is what an agent reads back after every command.

DeckTalk ships no MCP server. The CLI with `--json` and its exit codes is the machine interface, and
the skills teach an agent to use it.