설치된 스킬의 출처
에이전트 스킬은 home-manager에 의해 ~/.claude/skills/, ~/.agents/skills/, ~/.codex/skills/에 설치됩니다. 이 관리 경로는 소스 스킬 디렉토리에 연결됩니다. 설치된 링크를 편집하지 말고 소유 저장소를 편집하세요.
공유 스킬 소스와 리소스는 워크스페이스의 agent-skills/skills/<name>/ 디렉토리에 있습니다. Nix 카탈로그 agent-skills/catalog.nix는 소비자를 위한 공유 스킬을 선택합니다. 다운스트림 오버레이는 자체 machines.claude.skills 및 machines.codex.skills 구성을 통해 로컬 스킬 경로를 추가할 수 있습니다. 해당 파일들은 다운스트림 저장소에 유지하세요.
공유 스킬 편집
- 워크스페이스
agent-skills체크아웃에서 해당 디렉토리를 편집합니다. - 변경 사항이 소비자도 업데이트하는 경우 두 저장소 모두 동일한 기능 브랜치를 사용합니다. 워크스페이스에
agent-skills가 없으면addsrc agent-skills [email protected]:goromal/agent-skills.git명령으로 추가합니다. - 필요한 경우 임시 로컬 flake 입력을 사용하여 anixpkgs 통합을 테스트합니다. 푸시하기 전에 원격 기능 브랜치 URL을 복원하고
nix flake update agent-skills로 잠급니다. agent-skillsPR을 열고 소비자 PR에서 연결합니다. 먼저 스킬 소스 PR을 병합한 다음 소비자를 병합된main리비전으로 다시 고정합니다.
공유 스킬 생성
agent-skills에skills/<skill-name>/SKILL.md를 추가합니다. 참조, 예제, 스크립트 및 에셋은 그 옆에 함께 둡니다.catalog.nix에{ name = "<skill-name>"; file = ./skills/<skill-name>/SKILL.md; }항목을 추가합니다. 기본적으로 항목은 Claude와 Codex 모두에 적용됩니다. 필요한 경우frameworks를 설정합니다.- 지원 리소스를 스킬 폴더에 상대 경로로 연결하고 다운스트림 lock을 업데이트합니다.
다운스트림 로컬 스킬 편집
스킬 경로를 제공하는 오버레이나 모듈을 소유한 저장소에서 변경합니다. 디렉토리를 자체 포함으로 유지하고 참조를 포함합니다. 해당 구성은 프레임워크의 스킬 옵션에 { name, file } 항목을 추가할 수 있습니다.
공유 스킬 삭제 또는 교체
catalog.nix에서 해당 항목을 제거하고 소스 폴더를 삭제한 다음 다운스트림 lock을 업데이트합니다. 한 머신에서 공유 스킬을 교체하려면 machines.agents.excludedSkills에 해당 스킬 이름을 나열하고 다운스트림 모듈에서 해당 이름으로 로컬 스킬 경로를 추가합니다.