メニュー
LLM 컨텍스트 윈도우를 효율적으로 사용하는 3단계 정보 로드 원칙. Skills, Agents, Prompts 작성 시 참조. SKILL.md, AGENT.md 작성, 프롬프트 설계, 컨텍스트 최적화 시 활성화.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
SOC 職業分類に基づく
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/khw1031/ai-library --skill progressive-disclosureコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
소프트웨어 프로젝트의 소스 코드를 체계적으로 분석합니다. 프로젝트 경로를 입력하면 아키텍처, 데이터 흐름, 설계 패턴, 의존성을 단계별로 파악합니다. 소스 분석, 코드 분석, 리버스 엔지니어링, 아키텍처 분석, 코드베이스 파악 요청 시 활성화.
Claude Code Skill을 생성하거나 기존 스킬을 개선합니다. 스킬 생성, 스킬 수정, SKILL.md 작성, 새 스킬 만들기, 스킬 개선, 스킬 업데이트 요청 시 활성화.
Claude Code Skill을 생성하거나 기존 스킬을 개선합니다. 스킬 생성, 스킬 수정, SKILL.md 작성, 새 스킬 만들기, 스킬 개선, 스킬 업데이트 요청 시 활성화.
| name | progressive-disclosure |
| description | LLM 컨텍스트 윈도우를 효율적으로 사용하는 3단계 정보 로드 원칙. Skills, Agents, Prompts 작성 시 참조. SKILL.md, AGENT.md 작성, 프롬프트 설계, 컨텍스트 최적화 시 활성화. |
정보를 필요한 시점에 필요한 만큼만 로드하여 컨텍스트 윈도우를 효율적으로 사용합니다.
LLM의 컨텍스트 윈도우는 제한된 자원입니다. 모든 정보를 한 번에 로드하면:
Progressive Disclosure는 정보를 3단계로 나누어 필요할 때만 로드합니다.
| 단계 | 로드 시점 | 토큰 | 내용 |
|---|---|---|---|
| 1단계 | 항상 | ~100 | name, description, 트리거 키워드 |
| 2단계 | 활성화 시 | <5000 | 핵심 규칙, 필수 지침 |
| 3단계 | 요청 시 | 무제한 | 예제, 상세 문서, 스크립트 |
| 대상 | 1단계 | 2단계 | 3단계 |
|---|---|---|---|
| Skills | frontmatter | SKILL.md 본문 | references/, scripts/ |
| Agents | frontmatter | AGENT.md 본문 | references/, hooks |
| Prompts | 역할 정의 | 핵심 지침 | 예제, 참조 문서 |
Rule 대신 Skill 사용을 권장합니다.
기존 Rule을 Skill로 변환하면 더 유연하고 강력한 기능을 활용할 수 있습니다.
| Rule 사용 의도 | Skill 설정 |
|---|---|
| 매 세션 자동 적용 | user-invocable: false |
| 특정 조건에서만 적용 | description에 트리거 조건 명시 |
| 누락 방지 필요 | core-skills로 그룹화 후 세션 시작 시 트리거 |
변환 예시:
# Before: Rule (rules/code-style.md)
---
description: 코드 스타일 규칙
paths:
- "**/*.ts"
---
# After: Skill (skills/code-style/SKILL.md)
---
name: code-style
description: >
TypeScript 코드 작성 시 적용되는 스타일 가이드.
코드 작성, 리뷰, 리팩토링 시 자동 참조.
user-invocable: false
---
asset-name/
├── AGENTS.md # 진입점 - 개요 (Claude 자동 인식)
├── [TYPE].md # 2단계 - 핵심 지침
├── CLAUDE.md # AGENTS.md 참조 (선택적, 호환성)
└── references/ # 3단계 - 상세 문서
└── *.md
| 파일 | 역할 | 크기 제한 |
|---|---|---|
| AGENTS.md | 진입점, Claude 자동 인식 | 최소화 |
| CLAUDE.md | AGENTS.md 참조 (선택적) | 최소화 |
| SKILL.md / RULE.md / AGENT.md | 핵심 지침 | <5000 토큰, <500줄 |
| references/*.md | 상세 문서, 예제 | 무제한 |
---
name: asset-name # 1-64자, 소문자/숫자/하이픈
description: > # 무엇 + 언제 사용하는지
무엇을 하는지 설명.
어떤 상황에서 사용하는지 트리거 키워드 포함.
---
description만 읽고 "이 자산이 필요한가?"를 판단할 수 있어야 합니다.
# 좋은 예
description: >
코드 리뷰 시 적용되는 품질 기준.
PR 리뷰, 코드 검토, 품질 점검 요청 시 활성화.
# 나쁜 예
description: 코드 리뷰 규칙
자산 작성 시 확인:
□ 1단계: description이 무엇+언제를 명확히 설명하는가?
□ 1단계: name이 디렉토리명과 일치하는가?
□ 2단계: 본문이 5000 토큰 이하인가?
□ 2단계: 하나의 관심사에 집중하는가?
□ 3단계: 상세 내용이 references/로 분리되었는가?
□ 3단계: 참조 경로가 1단계 깊이인가?
각 자산 유형별 상세 적용 방법: