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

> Skills — Anthropic Agent Skills 표준 기반 스킬(프롬프트 + 도구 묶음) 관리. All / Active / Inactive 3 탭

# Skills

# Skills

**경로**: 하단 툴바 **Skills**

`Manage agent skills (Anthropic Agent Skills standard)`

특정 작업 수행 절차·프롬프트·도구 조합을 **재사용 가능한 스킬 번들** 로 패키징해 관리합니다. 스킬이 활성화되면 사용자 입력에 맞춰 자동 매칭되어 해당 프롬프트·도구 셋이 세션에 주입됩니다.

<Frame>
  <img src="https://mintcdn.com/dnotitia-328335e7/3mgjFAVO5t1rKplH/images/image-36.png?fit=max&auto=format&n=3mgjFAVO5t1rKplH&q=85&s=0969c9352602626b815631329c71abf5" alt="Image" width="1359" height="830" data-path="images/image-36.png" />
</Frame>

## UI 구성

| 요소                 | 설명                                            |
| ------------------ | --------------------------------------------- |
| **Import** 버튼      | 외부 스킬 파일·번들 가져오기                              |
| **New Skill** 버튼   | 신규 스킬 생성                                      |
| **All (N)** 탭      | 등록된 전체 스킬                                     |
| **Active (N)** 탭   | 현재 활성화된 스킬만                                   |
| **Inactive (N)** 탭 | 저장되었지만 비활성                                    |
| 빈 상태               | `No skills found. Create one to get started.` |

## Anthropic Agent Skills 표준이란?

Anthropic 이 표준화한 **스킬 패키지 형식**. 스킬은 마크다운 파일 + 메타데이터로 구성되며, 어떤 호환 에이전트(Claude Code·Seahorse 등) 에서든 **같은 스킬을 재사용** 할 수 있습니다.

### 스킬 구조 예

```yaml theme={null}
---
name: invoice-processor
description: 인보이스 PDF 에서 항목·금액 추출
when_to_use: PDF 업로드 + "인보이스" 키워드 감지 시
tools_required:
  - analytics.import_document_vlm
  - analytics.search_documents
---

당신은 인보이스 처리 전문가입니다.

1. 업로드된 PDF 를 VLM 파서로 인덱싱하세요.
2. "거래처·항목·수량·단가·총액" 을 추출합니다.
3. 결과를 아래 JSON 스키마로 반환:
   { vendor, items: [{name, qty, price, total}], grand_total }

근거가 부족하면 null 로 두고 추측 금지.
```

| 필드                  | 설명                    |
| ------------------- | --------------------- |
| **name**            | 스킬 식별자                |
| **description**     | 용도 한 줄                |
| **when\_to\_use**   | 자동 매칭 기준 (사용자 의도·트리거) |
| **tools\_required** | 이 스킬이 의존하는 도구 목록      |
| **본문**              | 시스템 프롬프트 역할           |

## 탭별 동작

| 탭            | 목록       | 주 용도                 |
| ------------ | -------- | -------------------- |
| **All**      | 전체 스킬    | 현황 확인·일괄 관리          |
| **Active**   | 매칭 대상 스킬 | 실제 동작 중인 것만 보기       |
| **Inactive** | 보관 스킬    | 테스트 중 / 폐기 예정 / 드래프트 |

각 스킬은 **Active ↔ Inactive** 토글로 상태 변경.

## 동작 흐름

<Steps>
  <Step title="스킬 등록">
    **New Skill** 로 직접 작성하거나 **Import** 로 외부 스킬(`.md` + 메타) 가져오기.
  </Step>

  <Step title="활성화">
    **Active** 로 토글 → 이후 세션의 메시지 입력마다 `when_to_use` 조건과 매칭 시도.
  </Step>

  <Step title="자동 매칭·주입">
    사용자 메시지가 트리거 조건과 일치하면 해당 스킬의 **프롬프트 + 도구** 가 현재 대화 컨텍스트에 주입.
  </Step>

  <Step title="수행">
    에이전트가 스킬 본문을 지침 삼아 도구 호출·답변 생성.
  </Step>
</Steps>

## 활용 예시

| 스킬명                   | 트리거          | 효과                     |
| --------------------- | ------------ | ---------------------- |
| **invoice-processor** | PDF + "인보이스" | 자동 VLM 파싱 + 항목 추출 JSON |
| **legal-redflag**     | 계약서 업로드      | 조항 점검·리스크 플래그 요약       |
| **meeting-minutes**   | 회의 녹취록       | 시간·발화자·액션 아이템 정리       |
| **code-review**       | PR URL       | 변경 요약 + 잠재 이슈 표        |
| **weekly-report**     | `주간 보고` 키워드  | KPI 쿼리 → DOCX 템플릿 조립   |

## 운영 주의

<Warning>
  * **when\_to\_use 충돌** — 여러 스킬의 트리거가 겹치면 우선순위 정책이 없으면 혼란. 카테고리·키워드를 명확히 분리.
  * **tools\_required 누락** — 의존 도구가 등록되지 않은 에이전트에서는 스킬이 실패. [Tool Management](/console/agent-ops/agent-tool) 와 연동 확인.
  * **민감 지침 주의** — 스킬 본문도 결국 System Prompt 처럼 모든 호출에 전송됩니다. API 키·비밀번호 금지.
  * **Import 스킬 검증** — 외부에서 가져온 스킬은 프롬프트 인젝션 위험이 있을 수 있음. 본문을 반드시 검토.
  * **비용** — Active 스킬이 많으면 매칭·주입 과정에서 토큰 누적. 정기 정리. 한도·요금: [Billing](/billing)
</Warning>

## 관련 문서

* [Prompt Settings](/agent-chat/user-menu/prompt-settings) — 수동 프롬프트 토글 (Skills 는 자동 매칭)
* [MCP Tools](/agent-chat/toolbar/mcp-tools) — tools\_required 에 등록할 도구
* [Tool Management](/console/agent-ops/agent-tool) — 전역 도구 관리