Skills가 해결하는 과제

Skills를 왜 쓰는지는 문제를 먼저 봐야 이해됩니다.

문제 1 — 매번 설명해야 한다

리포트를 만들 때마다 이런 대화를 반복합니다.

우리 회사 리포트는 표지에 로고가 들어가고,
요약은 3줄 이내, 숫자는 천 단위 구분,
전월 대비는 반드시 괄호로 표기하고...

이 설명은 매번 토큰을 쓰고, 매번 조금씩 달라집니다. 그리고 가끔 빠뜨립니다.

Skills는 이 설명을 한 번 쓰고 고정합니다.

문제 2 — 결과에 편차가 생긴다

같은 요청인데 어제와 오늘 결과 형식이 다릅니다. 사람이 매번 다르게 설명했기 때문입니다.

Skills는 절차를 고정하므로 같은 요청에 같은 형식이 나옵니다.

문제 3 — 컨텍스트를 낭비한다

"혹시 필요할까 봐" 참조 문서를 통째로 넣어 두면, 정작 쓰이지 않는 날에도 비용을 냅니다.

Skills는 설명만 상주하고 본문은 필요할 때만 로드합니다. 이것이 점진적 로딩입니다.

문제 4 — 지식이 사람에게 묶인다

"이건 김 대리한테 물어봐야 해"라는 절차가 있다면, 그 사람이 휴가 가면 멈춥니다.

Skill로 만들어 두면 사람도 읽고 AI도 실행합니다. 문서화의 부산물로 자동화가 따라옵니다.

사례 — 코드 리뷰 기준

Skill로 만들기 전:

• 리뷰어마다 지적 포인트가 다름
• 신입은 무엇을 봐야 할지 모름
• 같은 지적이 반복됨

Skill로 만든 후:

---
name: code-review
description: PR 코드 리뷰 시 사내 기준으로 검토한다.
---

## 반드시 확인할 것
1. 새 API 라우트에 인증 검사가 있는가
2. DB 조회에 페이지네이션이 있는가
3. 사용자 입력이 검증 없이 쓰이는 곳이 있는가
4. 에러가 조용히 삼켜지는 곳이 있는가

## 지적하지 말 것
- 포매터가 처리하는 스타일 문제
- 개인 취향에 가까운 네이밍

마지막 "지적하지 말 것"이 중요합니다. 하지 말아야 할 것을 적는 게 결과를 더 크게 바꿉니다.

정리

Skills가 해결하는 것은 결국 하나입니다. 반복되는 맥락 전달 비용.

다음 레슨

도메인 지식과 컨텍스트