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

# aether skill

> Manage saved user skills from the command line

Saved user skills are reusable `SKILL.md` instruction packs that the agent can load into any task. Use this command to push local skill folders to your account, pull them back, and keep them in sync. For the concepts behind skills, see [Skills](/concepts/skills); for an end-to-end walkthrough, see the [Skills guide](/guides/skills).

## Subcommands

| Command                          | Description                                  |
| -------------------------------- | -------------------------------------------- |
| `aether skill list`              | List your saved user skills                  |
| `aether skill get <slug>`        | Show a saved skill (optionally its files)    |
| `aether skill push <dir>`        | Upload a local skill folder as a saved skill |
| `aether skill pull <slug> <dir>` | Download a saved skill to a local directory  |
| `aether skill sync`              | Discover local skills and upload them        |
| `aether skill delete <slug>`     | Delete a saved skill                         |

## `list`

```bash theme={null}
aether skill list
```

Lists every saved user skill with its slug, source, and description.

## `get`

```bash theme={null}
aether skill get my-skill
aether skill get my-skill --files
aether skill get my-skill --out ./my-skill
```

<ParamField path="--files" type="bool">
  Show the skill's file list.
</ParamField>

<ParamField path="--out" type="string">
  Write the skill's files to this directory.
</ParamField>

## `push`

```bash theme={null}
aether skill push ./skills/code-review
aether skill push ./skills/code-review --slug code-review --force
```

The skill folder must contain a `SKILL.md` manifest. By default the slug is the basename of `<dir>`.

<ParamField path="--slug" type="string">
  Slug override (default: basename of `<dir>`).
</ParamField>

<ParamField path="--force" type="bool">
  Skip the overwrite confirmation if the slug already exists.
</ParamField>

## `pull`

```bash theme={null}
aether skill pull code-review ./skills/code-review
aether skill pull code-review ./skills/code-review --force
```

<ParamField path="--force" type="bool">
  Overwrite the target directory if it is non-empty.
</ParamField>

## `sync`

```bash theme={null}
aether skill sync
aether skill sync --dry-run
aether skill sync --source ./skills --force
```

Discovers local skill folders and uploads them.

<ParamField path="--source" type="string">
  Override the local source directories. Repeatable.
</ParamField>

<ParamField path="--dry-run" type="bool">
  List what would be uploaded without uploading.
</ParamField>

<ParamField path="--force" type="bool">
  Overwrite existing skills without prompting.
</ParamField>

## `delete`

```bash theme={null}
aether skill delete code-review --force
```

<ParamField path="--force" type="bool">
  Skip the confirmation prompt.
</ParamField>