# Docs

> Prelude agent guide

- Skill: `darkmatter/docs` (Agent Skill, multi-file: 33 files)
- Install (CLI): `npx skillmds@latest add darkmatter/docs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/darkmatter/docs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: darkmatter (https://skillmd.com/u/darkmatter)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/darkmatter/docs

---

# Prelude agent guide

Prelude is a flake-parts devshell UI: a welcome banner, command catalogue,
Markdown docs viewer, and themed prompt. This command prints the upstream
Markdown directly—no TUI, checkout, or network access after Nix resolves the
flake.

Start a project with:

```sh
nix run github:darkmatter/prelude -- wizard
```

Read a topic with:

```sh
nix run github:darkmatter/prelude#skill -- <topic>
```

Use `nix run github:darkmatter/prelude#skill -- list` before guessing. Topics:

- `install` — wizard output, flake-parts wiring, and reference consumer.
- `options` — complete generated `prelude.*` reference.
- `commands` — `x`, `motd`, and `docs` command contracts.
- `configuration` — common option groups and docs configuration.
- `guide command-conventions` — catalogue ownership and dispatch rules.
- `guide title-rendering` — FIGlet title and wizard details.