> ## 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.

# evolve skill

> Upload and manage platform-stored skills.

```bash theme={null}
evolve skill <command> [options]
```

## skill list

```bash theme={null}
evolve skill list [options]
```

List your uploaded skills, newest first.

<ParamField path="-l, --limit" type="n">
  Page size.
</ParamField>

<ParamField path="--cursor" type="c">
  Resume from a page cursor.
</ParamField>

<ParamField path="--columns" type="keys | all | help">
  Choose and order columns, comma-separated. `help` lists the keys.
</ParamField>

<ParamField path="-q, --quiet">
  Print only ids, one per line, for piping.
</ParamField>

<ParamField path="--no-trunc">
  Full cell content instead of one-line truncation.
</ParamField>

<ParamField path="--no-headers">
  Omit the header row in piped (TSV) output.
</ParamField>

## skill upload

```bash theme={null}
evolve skill upload <dir>
```

Upload a skill folder. Its name becomes your moving name pointer.

## skill show

```bash theme={null}
evolve skill show <id | name:<skill-name>>
```

Show one uploaded skill: its metadata and its `SKILL.md`.

```bash theme={null}
evolve skill show name:my-skill
```

## skill delete

```bash theme={null}
evolve skill delete <id>
```

Delete an uploaded skill record. Past jobs keep their locks. Refused (`skill_in_use`, 409) while a running job references it.

## Global options

<ParamField path="--json">
  Machine-readable JSON output.
</ParamField>

<ParamField path="--api-key" type="key">
  API key. Defaults to `$EVOLVE_API_KEY`.
</ParamField>

<ParamField path="--base-url" type="url">
  API base URL. Defaults to the Evolve dashboard API.
</ParamField>