<!-- generated by epythet -->

# For AI agents

`tituli` ships artifacts for coding agents alongside its code. This page lists
them, says where each lives in the repository, and points at the
machine-readable copies of this documentation.

## Skills

Skills are folders holding a `SKILL.md` (the [Agent Skills](https://agentskills.io) format): a description that tells an agent when to use it and a body with the procedure. Install one into your agent with `gh skill` (any host: `--agent claude-code`, `copilot`, `cursor`, `codex`, `gemini`), or use the copy bundled in the wheel.

### `tituli`

Put tasteful text on video or stills with the `tituli` Python package — title cards, end credits from structured data, captions with a tiny source attribution that stay off the subject, lower thirds, editorial context notes, and calligrams / concrete poems (text along a circle, wave, SVG path, or falling like Apollinaire’s “Il pleut”). Use when asked to “add credits”, “add a title card”, “caption this image”, “label these stills”, “put a name and role on screen”, “add context cards”, “overlay text on this video”, “make a calligram”, “text on a path”, or when a film needs on-screen text that looks designed rather than debug-dumped. Owns placement (title-safe, subject-avoiding, YouTube subtitle band reserved), ink/scrim by contrast, wrapping and shrink-to-fit, scheduling of captions against heavier cards, and ffmpeg compositing. Not for SRT subtitles (use `mixing`).

```bash
gh skill install thorwhalen/tituli tituli --agent claude-code
```

Source: [`tituli/data/skills/tituli`](https://github.com/thorwhalen/tituli/tree/HEAD/tituli/data/skills/tituli) (bundled with the pip package).

The bundled skills are also on disk after `pip install tituli`, under the package’s `data/skills/` directory; link them into an agent without network access with `skill link-skills <that directory>`.

## Instruction files

Files agents read before working in this repository.

- [`.claude/CLAUDE.md`](https://github.com/thorwhalen/tituli/tree/HEAD/.claude/CLAUDE.md): read by Claude Code

## Machine-readable documentation

This site publishes the same documentation in forms that fit an agent’s context window:

- [`llms.txt`](https://thorwhalen.github.io/tituli/llms.txt): an index of every page with a one-line description ([llms.txt](https://llmstxt.org) format)
- [`tituli.md`](https://thorwhalen.github.io/tituli/tituli.md): the whole documentation as one Markdown file
- `<page>.html.md`: a rendered Markdown twin of every page, advertised from each page’s `<head>` with `<link rel="alternate" type="text/markdown">`
- [`objects.inv`](https://thorwhalen.github.io/tituli/objects.inv): the Sphinx inventory: a symbol-to-URL index (`sphobjinv convert plain objects.inv -`)
