AI 맥락에서 "스킬"이란 무엇이며, 당신의 워크플로용으로 어떻게 만드나요?

Question

Accepted Answer

**스킬(skill)**은 AI 에이전트를 위한 재사용 가능한 온디맨드 워크플로를 패키징합니다. 반복되는 작업에 대한 **지침**(언제, 어떻게 하는지)과, 작업이 관련될 때만 에이전트가 로드하는 **선택적 스크립트나 리소스**로 구성됩니다. 매번 절차를 다시 설명하는 것과 한 번 가르치는 것의 차이입니다.

## 스킬이란

```text
SKILL = 에이전트가 필요할 때 끌어오는 자체 완결적 폴더:
  SKILL.md   → 메타데이터 + 지침(TRIGGER + STEPS)
  scripts/   → 에이전트가 실행하는 선택적 헬퍼 스크립트(예: linter, generator)
  resources/ → 선택적 템플릿, 예시, 참조 파일
→ 관련될 때만 로드 → 기본 컨텍스트를 작게, 워크플로를 반복 가능하게 유지
```

이점은 **progressive disclosure**(점진적 공개)입니다. 에이전트는 짧은 설명만으로 스킬이 *존재*함을 알고, 일치하는 작업이 나타날 때만 전체 지침과 스크립트를 끌어옵니다 — 그래서 수십 개의 스킬이 매 대화를 부풀리지 않습니다.

## 스킬 만들기

스킬은 세 부분으로 구성됩니다. **trigger**(언제), **steps**(어떻게), 그리고 **헬퍼 스크립트**(도구)입니다. 집중되고 조합 가능하게 유지하세요 — 한 가지 일을 잘, 잡다하게 다 넣지 말고.

```markdown
---
name: changelog-entry
description: Add a CHANGELOG entry. Use when finishing a user-facing change.
---
# Add a changelog entry

## Steps
1. Read the latest commits since the last release tag.
2. Categorize each as Added / Changed / Fixed.
3. Prepend a dated section to CHANGELOG.md under [Unreleased].
4. Run `scripts/validate.sh` to check the format.
```

`description`가 **trigger**입니다 — 에이전트에게 이 스킬을 언제 꺼낼지 알려줍니다. 번호 목록은 **steps**이고, `validate.sh`는 형식을 강제하는 **헬퍼 스크립트**여서 에이전트가 형식을 처음부터 추론할 필요가 없습니다. 스킬이 작고 단일 목적이므로 다른 스킬과 깔끔하게 조합됩니다(예: 별도의 "release" 스킬이 이를 호출 가능).

## 왜 중요한가

스킬은 에이전트를 끊임없이 다시 브리핑해야 하는 범용 비서에서, *당신의* 반복 절차를 아는 비서로 바꿉니다. trigger, steps, 스크립트를 집중되고 조합 가능하며 온디맨드로 로드되는 단위로 패키징하면, 조직의 지식을 한 번 인코딩해 안정적으로 재사용합니다 — 반복 작업에서 다시 설명하지 않고도 일관된 결과를 얻고, 모든 요청마다 모든 워크플로의 컨텍스트 비용을 치르지 않습니다.