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 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).

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

Source: 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.

Machine-readable documentation

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

  • llms.txt: an index of every page with a one-line description (llms.txt format)

  • 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: the Sphinx inventory: a symbol-to-URL index (sphobjinv convert plain objects.inv -)