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

# Skills

> Mount skills into every agent run, from a git source or from your uploads.

A skill is a folder of instructions mounted into the agent's run. Give a job one or more with `--skills`; every arm gets them.

```bash theme={null}
evolve run \
  -d terminal-bench-4@4.0 \
  -a claude \
  -m fable \
  --skills skills.sh/acme/skills/pdf \
  -l 5 \
  --watch
```

`--skills` (also spelled `--skill`) repeats, and accepts:

* `skills.sh/<owner>/<repo>[/<skill>]`
* `org/repo[@ref]`
* an https git URL
* `upload:<id>`, a skill you uploaded
* `name:<skill-name>`, your moving name pointer, resolved on the server to its current upload
* a local folder, which is uploaded first and then referenced

## Upload a skill

```bash theme={null}
evolve skill upload ./my-skill
evolve skill list
evolve skill show name:my-skill
evolve skill delete <id>
```

The folder's name becomes your moving name pointer: `name:my-skill` resolves to the latest upload with that name, and an unknown name is refused with `skill_name_not_found`. `skill show` prints the metadata and the `SKILL.md`. A skill that a running job references cannot be deleted, and past jobs keep the version they ran with.

The job's arm records what mounted under `skill_locks`: name, pinned source, digest and, for a git skill, the repository and commit. A skill that cannot be fetched fails the trial as an infrastructure error, never as a score.

<Card title="skill reference" icon="terminal" href="/cli-reference/skill">
  Every flag of `evolve skill`.
</Card>
