---
title: Agent skills
description: 에이전트에 안전한 Sume CLI 사용 패턴과 번들 skills 설치 방법을 살펴보세요.
---

Sume CLI 명령어는 에이전트 자동화를 명시적이고 감사 가능하게 만들도록
설계됐습니다.

## 읽기 전용부터 사용하기

계획 단계에서는 읽기 명령어를 먼저 사용하세요.

```bash
sume doctor --agent --json
sume catalog list --json
sume tools list --json
sume jobs status <job_id> --agent --json
sume jobs result <job_id> --agent --json
```

## 쓰기에는 확인 요구하기

에이전트는 운영자의 명시적인 확인 없이 리소스를 만들거나 유료 프로바이더
작업을 제출해서는 안 됩니다.

| 게이트 | 용도 |
|---|---|
| `--confirm-submit` | Job 취소나 에셋 등록처럼 유료가 아닌 쓰기입니다. |
| `--confirm-paid` | 크레딧을 예약하거나 소모할 수 있는 생성입니다(Avatar / Avatar Video). |

Image, Video, Music 생성은 아직 CLI 제출 명령어가 아닙니다. 이 계열들은
에이전트가 [Developer API](/public-api)를 호출하고, 필요하면 CLI Job 복구를
함께 쓰세요.

## 민감한 출력 가리기

자동화가 명령어 출력을 읽는다면 `--agent --json`을 사용하세요. agent 모드는
지원하는 곳에서 URL 형태의 필드와 계정·워크스페이스 정보를 가리거나
요약합니다.

## 번들 skills

패키징된 Sume skill을 로컬 에이전트 skill 디렉터리에 설치하거나 갱신합니다.

```bash
sume skills list
sume skills install
sume skills update
sume skills export sume
sume skills remove sume
```

`sume skills install`은 `.agents/skills` 또는 `.claude/skills`에 씁니다. 커스텀
설치 전에 소스 파일을 확인하려면 `export`를 사용하세요.

## 에이전트를 위한 MCP

Cursor/Claude 원격 커넥터에는 [호스팅 MCP](/mcp)(`https://mcp.sume.com/mcp`)를
권장합니다. 로컬 `sume mcp`는 현재 CLI 릴리스에서 출시되지 않았습니다.
`sume mcp doctor --json`과 [CLI 명령어 레퍼런스](/cli/commands)에서
살펴보세요.

## 권장 루프

1. 카탈로그와 로컬 준비 상태를 확인합니다.
2. 읽기 전용 또는 스키마 명령어로 페이로드를 검증합니다.
3. 쓰기나 유료 작업 전에 확인을 요청합니다.
4. 범위가 제한된 Job을 하나 제출합니다(Avatar는 CLI, Image/Video/Music은 API).
5. Job status/events/result 명령어로 복구합니다.
6. 비밀 값이나 서명된 URL을 붙여 넣지 않고 결과를 요약합니다.