컨텍스트 윈도우는 에이전트의 작업 공간입니다. 공간은 한정돼 있습니다. 전역에 Skills를 수십 개 저장하면 불필요한 데이터까지 로드되어 작업 공간이 낭비됩니다.

Claude Code의 Skills는 전역과 프로젝트 전용 두 가지 방식으로 설치합니다. 전역 설치는 모든 프로젝트에 Skill이 로드됩니다. 프로젝트별로 필요한 자료만 올리는 게 효율적입니다. 파일을 직접 복사하면 원본 업데이트를 프로젝트마다 수동으로 반영해야 합니다.

symlink를 활용한 효율적인 워크플로우

symlink는 파일 본체를 한곳에 두고 여러 곳에서 참조합니다. Skill 관리에 최적입니다. 원본을 창고에 하나만 두고 프로젝트에는 연결만 만듭니다.

설정은 세 단계입니다. 먼저 ~/GitHub 같은 폴더에 오픈소스 Skills 프로젝트를 전부 clone합니다. 이 폴더가 원본 창고 역할을 합니다. 프로젝트에서 Skill이 필요할 때 복사 대신 symlink를 생성합니다. 마지막으로 .claude/skills 경로를 .agents/skills로 연결해 에이전트가 원본을 참조하게 합니다.

유지보수와 기여 자동화

명령어를 외울 필요는 없습니다. 에이전트에게 자연어로 연결을 요청하면 symlink를 생성합니다. 추가나 삭제도 간단합니다. 작업자가 위치만 지정하면 나머지는 에이전트가 처리합니다.

업데이트도 한 번에 끝납니다. 창고 폴더에서 git pull을 실행하면 모든 프로젝트의 Skill이 최신 상태가 됩니다. 프로젝트에서 버그를 발견하고 에이전트에게 수정을 시키면 창고의 원본이 바로 바뀝니다. 이 수정 내용을 PR로 올리면 오픈소스 기여까지 자연스럽게 이어집니다. 원본 하나로 관리하면 Skill이 늘어나도 부담이 없습니다.

요약

  • 전역 설치보다 프로젝트별 설치가 컨텍스트 윈도우 관리에 유리합니다
  • symlink를 활용하면 파일 복사 없이 여러 프로젝트에서 동일한 원본을 참조할 수 있습니다
  • 원본 창고 관리 방식은 업데이트와 오픈소스 기여를 동시에 해결합니다