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

> AI 코딩 에이전트용 vesslctl 스킬을 설치하는 방법을 알아봐요.

`skill` 명령어를 사용하면 AI 코딩 에이전트(Claude Code, Codex, Gemini CLI, Cursor 등)가 VESSL Cloud 리소스를 직접 관리할 수 있도록 스킬 파일을 설치하고 확인할 수 있어요.

스킬은 [Agent Skills 오픈 표준](https://agentskills.io/home)을 따라요.

## install

`vesslctl` 스킬 파일을 대상 위치에 설치해요. 대화형 모드에서는 대상을 선택할 수 있으며, 비대화형 모드에서는 `--target`을 사용해 주세요.

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

| 플래그        | 단축   | 설명                                                                               |
| ---------- | ---- | -------------------------------------------------------------------------------- |
| `--target` |      | 대상 위치: `cross-client` (`~/.agents/skills`) 또는 `claude-code` (`~/.claude/skills`) |
| `--dir`    | `-d` | 커스텀 대상 디렉터리(대상 기본값 덮어쓰기)                                                         |
| `--force`  |      | 기존 파일을 확인 없이 덮어쓰기                                                                |

**사용 가능한 대상:**

| 대상             | 기본 디렉터리            | 설명                 |
| -------------- | ------------------ | ------------------ |
| `cross-client` | `~/.agents/skills` | 모든 코딩 에이전트에서 사용 가능 |
| `claude-code`  | `~/.claude/skills` | Claude Code 네이티브   |

**예시:**

```bash theme={null}
# 대화형 선택
vesslctl skill install

# Claude Code에 설치
vesslctl skill install --target claude-code

# 커스텀 디렉터리에 설치
vesslctl skill install --dir ~/my-skills

# 기존 파일 강제 덮어쓰기
vesslctl skill install --target cross-client --force
```

이 명령어는 멱등(idempotent)이에요. 다시 실행하면 이미 최신인 파일은 건너뛰어요.

## show

번들된 `vesslctl` 스킬 파일의 원본 내용을 표시해요.

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

`--output json`을 사용하면 이름, 설명, 내용이 포함된 JSON 객체로 출력해요.

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