# The skill

The skill is the instructions an agent follows while it builds a site. It
is not these docs.

These pages say what a thing is. The skill says what to do next, and in
what order.

## Where it lives

Clave serves it:

```sh
curl https://api.heyclave.party/v1/skill
```

`GET /v1/skill/{path}` reads one file of the tree.

Every client reads the copy the platform serves. No client holds one that
can go stale, and `GET /v1/account` reports the version that is live.

## What it holds

- **`SKILL.md`**, the stack, the rules and the voice to use with an owner.
- **stage files**, which walk discovery, brief, design, voice, build and
  ship.
- **design guidance**, so no companion skill is needed.
- **a terminal client**, at `bin/clave.mjs`.

The client travels with the skill. A stage file must never name a command
the checkout does not have.

## The system of record

The skill keeps what is true about a site in the site's own `docs/`
directory, in git. Intent then lives on disk rather than in a
conversation, so a new session picks up where the last one stopped.

## Use it

Point your agent at the served tree. Then read
[the terminal client](/agents/terminal) for the commands.

---

## Where this page sits

This is one page of the Clave documentation.
Read it as a web page at https://docs.heyclave.party/agents/skill.
Every page has a `.md` address, and https://docs.heyclave.party/llms.txt lists them all.

- Previous: [The chat connector](https://docs.heyclave.party/agents/connector.md)
- Next: [The terminal client](https://docs.heyclave.party/agents/terminal.md)
- Index: [Overview](https://docs.heyclave.party/index.md)