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

# vesslctl skill

> Install vesslctl skills for AI coding agents.

The `skill` command lets you install and inspect vesslctl skill files so AI coding agents — such as Claude Code, Codex, Gemini CLI, and Cursor — can manage VESSL Cloud resources directly.

Skills follow the [Agent Skills open standard](https://agentskills.io/home).

## install

Install vesslctl skill files to a target location. When run interactively, it prompts you to choose a target. In non-interactive mode, use `--target`.

```bash theme={null}
vesslctl skill install
```

| Flag       | Short | Description                                                                                |
| ---------- | ----- | ------------------------------------------------------------------------------------------ |
| `--target` |       | Target location: `cross-client` (`~/.agents/skills`) or `claude-code` (`~/.claude/skills`) |
| `--dir`    | `-d`  | Custom target directory (overrides the target default)                                     |
| `--force`  |       | Overwrite existing files without prompting                                                 |

**Available targets:**

| Target         | Default Directory  | Description                  |
| -------------- | ------------------ | ---------------------------- |
| `cross-client` | `~/.agents/skills` | Works with all coding agents |
| `claude-code`  | `~/.claude/skills` | Claude Code native           |

**Examples:**

```bash theme={null}
# Interactive selection
vesslctl skill install

# Install to Claude Code
vesslctl skill install --target claude-code

# Install to a custom directory
vesslctl skill install --dir ~/my-skills

# Force overwrite existing files
vesslctl skill install --target cross-client --force
```

The command is idempotent — running it again skips files that are already up to date.

## show

Display the raw contents of the bundled vesslctl skill file.

```bash theme={null}
vesslctl skill show
```

Use `--output json` to get the skill content as a JSON object with name, description, and content fields.

```bash theme={null}
vesslctl skill show --output json
```