agent-skills은(는) 무엇을 하나요?
~/Dev/agent-skills는 내가 프로젝트에서 사용하는 모든 스킬(내 스킬과 내가 기반으로 하는 업스트림 스킬)을 보관합니다. agent-skills link는 ~/.claude/skills(Claude Code)와 ~/.agents/skills(Codex)를 이 저장소로의 심볼릭 링크로 채우므로, 두 폴더 중 하나를 통해 편집된 스킬은 저장소에서 편집됩니다.
스킬이 속하는 위치
- 프로젝트 스킬(저장소 자체의
.agents/skills/, 예:verify-*): 해당 프로젝트에 남아 있습니다. 이 파일의 나머지 내용은 이 저장소의 스킬에 관한 것입니다. - 내 스킬:
skills/<name>/. - 업스트림:
vendor/<upstream>/,agent-skills update로 pstack, Matt Pocock의 스킬, good-css에서 가져옵니다.upstreams.ts는 그들의 스킬 중 어떤 것을 링크할지 선택합니다. - 저장소로의 심볼릭 링크가 아닌 에이전트 폴더의 모든 것(
blabla-*, Claude의synced/, Codex의.system/)은 해당 도구가 소유하며, 도구가 업데이트합니다.
realpath ~/.agents/skills/<name>은 스킬이 어떤 것인지 알려줍니다.
생성
~/Dev/agent-skills/skills/<name>/SKILL.md에 스킬을 생성합니다. 해당 경로는 skill-creator 및 /automate-me의 기본값보다 우선합니다. 그런 다음 agent-skills link를 실행합니다. 충돌이 보고되면 다른 이름을 선택하세요.
편집
변경 내용에 따라 경로를 결정합니다:
- 선호도(스타일, 기본값, 작업 방식)에 대한 변경: 내 스킬에 추가합니다.
skills/에 있는 스킬을 확장하거나 새로 만듭니다. 내 파일은 업스트림 업데이트와 충돌하지 않습니다. - 업스트림 스킬이 나에게 잘못 작동하는 부분에 대한 수정:
vendor/에 직접 적용합니다. 커밋된 업스트림 편집은agent-skills update이후에도 유지되지만, 업스트림이 같은 줄을 변경할 때 각각 충돌할 수 있으므로 작게 유지하세요. pstack을 편집한 후에는node ~/Dev/agent-skills/vendor/pstack/scripts/check-t3-native.mjs <name>을 종료 코드 0이 나올 때까지 실행하세요.
제거
내 스킬의 경우 skills/<name>/을 삭제합니다. 업스트림 스킬의 경우 먼저 나에게 물어보세요. upstreams.ts를 변경해야 할 수도 있습니다.
마무리
agent-skills link가 성공하고 각 변경 사항이 ~/Dev/agent-skills에서 각각의 커밋으로 푸시되면 완료됩니다:
- 변경한 파일만 스테이징합니다(
git add <paths>). 다른 에이전트가 작업 중일 수 있습니다. - 커밋 메시지에 스킬이 변경된 이유를 작성합니다.
- 커밋 후 즉시 푸시합니다.
작성
- 저장소는 공개되어 있으므로 모든 스킬을 공개 텍스트로 작성합니다: 일반적인 예제를 사용하고, 내 프로젝트의 이름, 경로, 비밀 정보를 포함하지 마세요.
- 다른 스킬을 참조할 때는 전체 경로(
~/.agents/skills/<name>/SKILL.md)를 사용하세요. 상대 경로../<name>은 여기서 작동하지 않습니다. 내 스킬과 각 업스트림이 서로 다른 폴더에 있기 때문입니다. - 작성 자체는
~/.agents/skills/writing-for-agents/SKILL.md를 따르세요.
agent-skills를 인수 없이 실행하면 명령어 목록을 볼 수 있습니다.