# 스킬 카탈로그

필요한 문서 형식, 제품 제약, 분야별 계약을 제공할 때 스킬을 선택합니다. 스킬은 작업 지침이며 실행 도구나 권한 부여 수단이 아닙니다. 스킬을 설치하지 않고 같은 기록 파일을 사용하는 것도 가능합니다.

## 프로필

| 프로필 | 포함하는 스킬 |
| --- | --- |
| `light` | `project-notes` 하나; 별도 참고 자료 없이 간단한 작업 연속성 지침 제공 |
| `core` (기본값) | `project-memory`, `spec-artifacts` |
| `development` | Core + `design-brief-direction`, `ui-polish`, `natural-writing-humanization` |
| `legacy` | `legacy-contracts` 하나 |

## 사용 상황과 요청 예시

| 스킬 | 필요한 상황 | 요청 예시 |
| --- | --- | --- |
| `project-notes` | 세션 사이에 이어 쓸 간단한 프로젝트 메모를 유지할 때 | 기존 프로젝트 형식으로 확인한 결과와 다음 행동을 기록해 줘 |
| `project-memory` | 현재 사실, 결정, 근거, 재개 지점을 정리할 때 | 테스트 결과와 다음 할 일을 CURRENT.md에 반영해 줘 |
| `spec-artifacts` | 명세, ADR, 계약, 인수인계의 구체적인 형식이 필요할 때 | 예시와 호환 조건이 있는 API 계약을 작성해 줘 |
| `design-brief-direction` | 제품 목적, 브랜드, 참고 사례, 정보 밀도를 정할 때 | 정보가 많은 운영 화면의 디자인 방향을 잡아 줘 |
| `ui-polish` | 이미 렌더링된 UI를 개선하거나 검토할 때 | 티켓 디자인을 유지하면서 키보드 이동과 간격을 다듬어 줘 |
| `natural-writing-humanization` | 사실과 문체를 보존하며 한국어·영어 글을 편집할 때 | 명령·수치·존댓말을 유지하면서 안내를 읽기 쉽게 고쳐 줘 |
| `legacy-contracts` | 오래된 기술 환경의 동작·호환 계약을 보존할 때 | 서버 렌더링 페이지 수정 전에 폼 전송과 인쇄 동작을 확인해 줘 |

선택한 SKILL.md를 읽고 필요한 경우에만 안의 참고 자료를 봅니다. 한국어 문장 예시는 자동 치환 규칙이 아닙니다. 레거시 참고 자료도 실제 기술 환경에 맞는 것을 고릅니다. 코드 정리는 선택형 참고 자료의 `quality/cleanup-ai-slop`에 별도로 보존합니다.

## 설치·확인·조합

```sh
ai-agent-playbook skills list --json
ai-agent-playbook skills install --profile development --dry-run --json
ai-agent-playbook skills install --skill project-memory --skill legacy-contracts --dry-run --json
```

`--skill`은 프로필에 추가되는 옵션이 아니라 프로필 대신 직접 목록을 지정하는 옵션입니다. 개발 프로필에 레거시를 더하려면 development를 설치한 다음 `--skill legacy-contracts`를 따로 설치하세요. 일반 설치는 다른 설치본을 삭제하지 않습니다. 갱신·확인·삭제 때도 해당 선택을 사용합니다. [설치 안내](lifecycle.ko.md)를 참고하세요.

기본 설치 위치는 `.agents/skills`입니다. 소스의 일곱 진입점, 선택해서 설치한 수, 앱이 검색하거나 대화에 넣은 수는 서로 다릅니다. 파일 설치 성공만으로 앱이 이름을 불러왔다고 판단하지 않습니다.

자동 선택, 명시적 요청, 스킬·MCP·문서 명령의 실제 활용 확인은 [에이전트의 도구 활용](agent-usage.ko.md)에서 설명합니다.

## 라이트 모드

간단한 연속성 메모면 충분할 때 `--profile light`를 선택합니다. 짧은 `project-notes` 진입점 하나를 설치하며 참고 자료 묶음이나 필수 동반 스킬이 없습니다. core나 development보다 선택되는 스킬의 설명과 지침 묶음이 작습니다. 전문 문서 형식, 디자인, UI와 글쓰기 지침은 포함하지 않습니다. 이런 기능이 필요하면 core나 development를 사용하세요.

앱이 이 스킬을 선택하면 관련 기록만 읽고, 요청하지 않은 작업 방식의 브랜드명이나 스킬명 설명을 생략하며 결과 중심으로 답하도록 안내합니다. 직접 질문, 필수 고지, 출처 표기와 앱·프로젝트 지침은 계속 따릅니다. 전역 응답 설정이 아니며 이름이 절대 나오지 않는다고 보장하지 않습니다. 이름, 설치 소유권 표시, 도구 기록과 서비스·회사의 감사 설정을 숨기거나 바꾸지 않습니다. 실제 문맥, 토큰, 비용과 앱의 스킬 발견 범위는 앱과 작업에 따라 달라지므로 절감률을 보장하지 않습니다.

일반 설치는 추가 방식입니다. development 위에 light를 설치해도 이전 스킬은 계속 남습니다. 명시적인 이전 미리보기에서 수정되지 않은 알려진 AAPB 설치본의 제거를 검토한 뒤 적용하고 백업을 보관하세요. 정리에는 선택한 대체 설치본이 유효해야 하며, 대체 설치가 실패하거나 바뀌면 남은 제거를 중단합니다. 수정본과 미관리 설치본은 남습니다. [라이트 설치와 프로필 전환](lifecycle.ko.md#라이트-설치와-프로필-전환)을 참고하세요.

부트스트랩은 스킬을 설치하거나 활성화하지 않습니다. 기존 `--records minimal` 선택으로 현재 상태 진입점과 설치 정보를 만들 수 있으며 별도 라이트 부트스트랩 옵션은 없습니다. 표준 기록 구성과 기존 이력도 라이트 스킬로 사용할 수 있습니다. Git 제외 설정은 모델 입력이나 서비스 기록을 제어하지 않습니다.

## 이전 스킬은 어디로 갔나요?

[94개 항목의 이전표](skill-decisions.ko.md)에 구버전 이름, 판정, 참고 자료 위치, 복구 경로가 있습니다. 일반 작업 절차와 호환용 이름을 중복 SKILL.md로 다시 설치하지 않습니다. 고유한 분야별 예시는 [선택형 참고 자료](../references/README.ko.md)에 남아 있습니다.

정해진 개수에 맞추기보다 현재 부족한 기능을 기준으로 선택하세요. 지침·실행 도구·앱 연동의 차이는 [기능 선택 기준](capability-taxonomy.ko.md)에서 설명합니다.