에이전트 코딩 · 2026년 9월 9일 ★★★★

스킬 파일을 어떻게 관리하냐는 해커뉴스 질문에 댓글 280개가 붙었고, 되풀이해 나온 답은 저장소 한 곳에 모아 두고 도구별 스킬 폴더로 심볼릭 링크를 거는 방식이에요

9월 6일 올라온 질문에 307점과 댓글 280개가 붙었어요. 답에 되풀이해 나온 방식은 스킬을 dotfiles 나 별도 git 저장소 한 곳에 두고 ~/.claude/skills, ~/.codex/skills, ~/.config/opencode/skills 로 심볼릭 링크를 걸거나 스크립트로 뿌리는 것이고, 인터넷에서 받은 스킬 묶음은 못 미덥다는 반응이 많아 각자 되풀이하는 프롬프트를 직접 스킬로 굳히는 쪽이 남았어요. 개수를 늘리는 데 대한 경고도 나왔는데, 클로드 코드 공식 문서는 스킬 설명이 세션 시작 때 맥락에 미리 들어가고 그 목록에 쓰는 몫이 창 전체의 1% 로 정해져 있으며 넘치면 덜 부른 스킬 설명부터 버린다고 적어 뒀어요.

용어 풀이
dotfiles
홈 디렉터리에 두는 개인 설정 파일 모음. 이름이 점으로 시작해서 붙은 이름
심볼릭 링크
원본 파일이나 폴더를 가리키기만 하는 바로가기 항목. 원본을 고치면 링크로 연 쪽도 같이 바뀜
SKILL.md
스킬 하나를 이루는 문서 파일. 앞머리에 이름과 언제 쓰는지를 적고 본문에 절차를 적음
PR
Pull Request. 고친 내용을 원래 저장소에 넣어 달라고 올리는 요청
운영자 인사이트

스킬을 저장소 한 곳에 두고 각 도구 폴더로 링크만 걸어 두면 도구를 갈아타도 그대로 따라오니 오늘 바로 옮겨 둘 만해요. 다만 개수를 늘리기 전에 설명을 줄이는 게 먼저인데, 클로드 코드는 설명과 사용 시점 문구를 1,536자에서 자르고 목록 몫이 넘치면 덜 부른 스킬부터 떨어뜨리니, 안 쓰는 스킬은 주기적으로 지우는 쪽이 이득이에요.

여러 관점으로 보기
  • 공식 문서가 못 박아 둔 스킬 목록 몫 스킬 설명은 세션 시작 때 맥락에 미리 들어가고, 목록에 쓰는 몫은 맥락 창의 1% 예요. 설명과 사용 시점 문구는 1,536자에서 잘리고 SKILL.md 는 500줄 안으로 두라고 적혀 있어요. Claude Code 공식 문서
  • 한 저장소에서 여러 도구로 뿌리기 스킬을 원본 git 저장소 두 곳에 두고 스크립트로 ~/.claude/skills, ~/.codex/skills, ~/.pi/agent/skills, ~/.config/opencode/skills 에 뿌리는데, 그 스크립트가 각 자리에서 직접 손댄 흔적이 없는지 먼저 확인한대요. Hacker News
  • 스킬이 문서와 어긋났는지 자동 점검 스킬을 저장소에 모아 두고 2주마다 에이전트 작업을 돌려 원본 문서와 어긋난 스킬을 찾아 PR 을 열어요. 사람마다 판이 달라지는 걸 막으려고 도구를 가리지 않고 갱신해 주는 Go 실행 파일도 따로 만들었대요. Hacker News
  • 남이 만든 스킬을 설치·갱신하는 도구 npx skills add·update 로 스킬을 설치하고 갱신하는 MIT 도구예요. 별이 3만 개 넘고 클로드 코드·코덱스·커서·코파일럿 등 75개 넘는 에이전트를 지원하는데, 이걸 쓴다는 댓글은 클로드 데스크톱에서는 안 된다는 단서를 달았어요. GitHub
  • 스킬을 아예 걷어낸 쪽 모델이 새로 나올 때마다 스킬 효과가 떨어지는 걸 겪어서 스킬을 다 없애고 에이전트 둘레에 정해진 대로만 도는 실행 틀을 짰대요. Hacker News
  • 많이 두면 안 읽혀도 값을 치러요 스킬 파일이 많으면 끝까지 읽히지 않아도 토큰이 늘어난다며, 개수를 정하는 게 아슬아슬한 선이라고 적었어요. Hacker News

원본 보기 (hn:top-stories)