菜单
LLM 컨텍스트 윈도우를 효율적으로 사용하는 3단계 정보 로드 원칙. Skills, Agents, Prompts 작성 시 참조. SKILL.md, AGENT.md 작성, 프롬프트 설계, 컨텍스트 최적화 시 활성화.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/khw1031/ai-library --skill progressive-disclosure命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
소프트웨어 프로젝트의 소스 코드를 체계적으로 분석합니다. 프로젝트 경로를 입력하면 아키텍처, 데이터 흐름, 설계 패턴, 의존성을 단계별로 파악합니다. 소스 분석, 코드 분석, 리버스 엔지니어링, 아키텍처 분석, 코드베이스 파악 요청 시 활성화.
Claude Code Skill을 생성하거나 기존 스킬을 개선합니다. 스킬 생성, 스킬 수정, SKILL.md 작성, 새 스킬 만들기, 스킬 개선, 스킬 업데이트 요청 시 활성화.
Claude Code Skill을 생성하거나 기존 스킬을 개선합니다. 스킬 생성, 스킬 수정, SKILL.md 작성, 새 스킬 만들기, 스킬 개선, 스킬 업데이트 요청 시 활성화.
基于 SOC 职业分类
| 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단계 깊이인가?
각 자산 유형별 상세 적용 방법: