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

# Skills

> Define reusable task-shaped playbooks and invoke them on demand.

Skills are reusable, task-shaped playbooks for work you run repeatedly.

## Required location

Store each skill at:

`.agents/skills/<skill-name>/SKILL.md`

Example:

`.agents/skills/upgrade-deps/SKILL.md`

## Invocation

Call a skill by name in your request:

`$<skill-name>`

Example: `$upgrade-deps`

## Minimal skill anatomy

A strong `SKILL.md` should include:

* **Goal**: what outcome the skill produces.
* **Inputs**: what context or parameters it expects.
* **Steps**: the execution sequence.
* **Return shape**: what output format to return.
* **Guardrails**: hard boundaries and safety constraints.

## Instructions vs. skills

* Put durable repo policy in [AGENTS.md instructions](/AGENTS.md-instructions).
* Put repeatable task workflows in skills.

If something should apply to every run, it belongs in `AGENTS.md`.
If it should apply only when explicitly requested, it belongs in a skill.