# Documentation

Start here if you are new to this repo.

## Reading path

1. [Setup guide](setup.md) — get the skills into your agent, editor, or harness.
2. [Workflow guide](workflow.md) — choose the right skill for the work in front of you.
3. [Usage reference](usage.md) — quick lookup for all skills and example prompts.

Maintainers should also read [release.md](release.md).

## Docs by type

| Type | Document | Use it when... |
|---|---|---|
| Tutorial / first run | [Setup guide](setup.md) | You need to load the bundle or a single skill somewhere. |
| How-to / workflow | [Workflow guide](workflow.md) | You know the kind of work and need the right skill. |
| Reference | [Usage reference](usage.md) | You want the full skill list, package names, and invocation examples. |
| Maintainer guide | [Release process](release.md) | You are validating, versioning, publishing, or tagging. |

## Fast answers

- **I do not use Pi. Can I still use this?** Yes. Each skill is a plain `SKILL.md` file. Load it as a custom instruction, rule, prompt, or context file in your tool.
- **Where do I start?** Use [workflow.md](workflow.md) to pick a skill, then open that skill's `SKILL.md`.
- **Do I need the whole bundle?** No. You can use one skill directory or one `SKILL.md` file.