활성화 계약
스킬을 설치, 제거, 생성, 이동 또는 이름을 변경한 후, 또는 위임자가 새로운 스킬 인덱스가 필요할 때 이 스킬을 사용하세요.
엄격 규칙
- 레지스트리는 인덱스이지 컴파일러나 요약이 아닙니다.
SKILL.md는 진실의 원천(source of truth)으로 남습니다. - 기본적으로 간결 규칙을 생성하거나 주입하지 마세요. 정확한 스킬 경로를 하위 에이전트에 전달하여 작성자의 의도를 보존하세요.
- SDD 지속 모드와 관계없이 항상
.atl/skill-registry.md를 작성하세요. - 레지스트리를 사용 가능한 경우
topic_key: skill-registry로 Engram에 저장하고capture_prompt: false로 설정하세요. sdd-*,_shared,skill-registry를 건너뛰고, 스킬 이름으로 중복을 제거하며 프로젝트 수준 스킬을 사용자 수준 스킬보다 우선시하세요.- 가능하면
.atl/을.gitignore에 추가하되, 명시적으로 비활성화된 경우는 제외합니다.
결정 게이트
| 상황 | 조치 |
|---|---|
| 동일한 스킬이 전역과 프로젝트에 존재하는 경우 | 프로젝트 수준 스킬을 유지 |
| 동일한 스킬이 여러 전역 위치에 존재하는 경우 | 스캔 순서에서 첫 번째 소스를 유지 |
| 발견된 스킬이 없는 경우 | 빈 레지스트리를 작성하여 에이전트가 맹목적으로 검색하는 것을 중단 |
| 에이전트가 작업을 위임할 경우 | 일치하는 레지스트리 행을 선택하고 해당 SKILL.md 경로를 전달 |
실행 단계
- 알려진 모든 사용자 및 프로젝트 스킬 디렉터리에서
*/SKILL.md를 스캔합니다. - 필요에 따라 프론트매터만 읽어
name과description트리거 텍스트를 추출합니다. - 스캔된 소스, 레지스트리 계약, 스킬 이름, 트리거/설명, 범위 및 정확한 경로를 사용하여
.atl/skill-registry.md를 렌더링합니다. - 사용 가능한 경우
title: skill-registry,topic_key: skill-registry,type: config,capture_prompt: false를 사용하여 Engram에 저장합니다. - 레지스트리 경로, 스킬 수, 캐시 상태 및 Engram 업데이트 여부를 반환합니다.
출력 계약
반환:
- 프로젝트 이름 및
.atl/skill-registry.md경로. - 인덱싱된 스킬 수.
- 캐시가 적중되었는지 또는 재생성되었는지 여부.
- 건너뛰거나 중복된 스킬이 있는 경우 해당 정보.
참고 자료
docs/skill-style-guide.md— 인덱싱 전에 스킬을 작성하는 방법.skills/_shared/skill-resolver.md— 위임자가 인덱스를 사용하는 방법.