Skill Cabinet이란?
Skill Cabinet은 컴퓨터에 설치된 에이전트 스킬을 위한 로컬 카탈로그입니다. 사용자 수준의 .agents, .claude, .codex, .cursor와 같은 폴더를 스캔하며 Cursor 플러그인도 포함합니다. 또한 일치하는 다른 ~/.* /skills 폴더도 확인합니다.
이 애플리케이션은 검색된 스킬을 브라우저 기반 인터페이스로 보여 줍니다. 카탈로그를 검색하고, 각 스킬의 콘텐츠와 YAML 프런트매터를 확인하며, 해당 폴더의 추가 파일을 열고, 원하지 않는 스킬을 디스크에서 삭제할 수 있습니다.
Skill Cabinet은 127.0.0.1에만 바인딩되므로 서버는 공용 네트워크 인터페이스가 아닌 로컬 컴퓨터를 통해서만 사용할 수 있습니다.
주요 기능
- 자동 검색: 지원되는 사용자 수준 에이전트 도구 폴더와 스킬 폴더를 스캔합니다.
- 필터링: 폴더별로 카탈로그 범위를 좁힙니다.
- 검색: 이름, 설명, 경로 또는 프런트매터와 일치하는 항목을 찾습니다.
- 스킬 검사: 렌더링된 형식 또는 소스 형식으로 스킬 본문을 표시합니다.
- 메타데이터 확인: 스킬에 연결된 YAML 프런트매터를 표시합니다.
- 폴더 탐색: 스킬과 함께 저장된 추가 파일을 읽을 수 있습니다.
- 스킬 삭제: 한 번에 스킬 하나 또는 표시한 여러 스킬을 삭제합니다.
- 테마: 테마 메뉴에서 선택 가능한 스킨을 제공하며, 기본값은 Carbon입니다.
- 키보드 탐색: 이동, 검색, 표시, 삭제를 위한 단축키를 지원합니다.
요구 사항
Skill Cabinet을 사용하려면 Node.js 20 이상이 필요합니다. 시작하기 전에 설치된 Node.js 버전을 확인하세요.
node --version표시된 주 버전이 20보다 낮으면 Node.js를 업그레이드한 다음 명령을 다시 실행하세요.
Skill Cabinet 실행
npm 패키지 시작
애플리케이션을 실행하는 가장 빠른 방법은 npx를 사용하는 것입니다.
npx skill-cabinet이 명령은 127.0.0.1에서 로컬 서버를 시작하고, 기본적으로 포트 3781을 사용하며, 브라우저에서 인터페이스를 엽니다.
GitHub 저장소에서 직접 실행
npm 패키지 대신 저장소 버전을 실행할 수도 있습니다.
npx github:subsy/skill-cabinet브라우저 자동 열기 방지
브라우저 탭을 바꾸거나 열지 않고 서버를 시작하려면 SKILL_CABINET_NO_OPEN을 설정하세요.
SKILL_CABINET_NO_OPEN=1 npx skill-cabinet시작한 후 준비가 되면 애플리케이션에 표시된 로컬 주소를 여세요.
다른 포트 선택
3781이 아닌 포트를 사용하려면 PORT 환경 변수를 설정하세요.
PORT=4000 npx skill-cabinet이 예시에서 Skill Cabinet은 127.0.0.1:4000에서 실행됩니다.
스킬 탐색 및 검색
npx skill-cabinet으로 Skill Cabinet을 시작합니다.- 브라우저에서 로컬 인터페이스가 열릴 때까지 기다립니다.
- 폴더 필터를 사용해 특정 지원 위치의 스킬에 집중합니다.
- 검색을 사용해 스킬의 이름, 설명, 경로 또는 프런트매터를 기준으로 찾습니다.
- 결과를 선택해 내용을 확인합니다.
설명의 일부, 디렉터리 경로 또는 YAML 메타데이터에 저장된 값만 기억나는 경우 검색이 유용합니다.
스킬 검사
스킬을 선택한 후 렌더링된 형식이나 소스 형식으로 본문을 읽을 수 있습니다. 편리하게 읽으려면 렌더링된 보기를 사용하고, 원본 텍스트를 확인하려면 소스 보기를 사용하세요.
스킬의 YAML 프런트매터를 확인하고 해당 디렉터리에 포함된 추가 파일을 읽을 수도 있습니다. 이러한 보기를 함께 사용하면 변경하기 전에 스킬의 내용과 설치 위치를 파악할 수 있습니다.
신중하게 스킬 삭제
Skill Cabinet은 개별 스킬 하나 또는 표시한 여러 스킬을 한 번에 삭제할 수 있습니다. 삭제하면 디스크에서 스킬 디렉터리 전체가 제거됩니다.
경고: 실행 취소 기능이 없습니다. 삭제하기 전에 선택한 스킬과 해당 경로를 주의 깊게 검토하세요.
기본 제공 Cursor 스킬과 플러그인 캐시에 저장된 복사본은 관련 도구가 다음에 업데이트될 때 다시 나타날 수 있습니다. 따라서 이러한 복사본을 삭제해도 영구적이지 않을 수 있습니다.
키보드 단축키 사용
키보드 명령을 사용하면 대규모 카탈로그를 더 빠르게 처리할 수 있습니다.
j다음 항목으로 이동합니다.k이전 항목으로 이동합니다./찾기를 활성화합니다.x항목을 표시합니다.d선택했거나 표시한 스킬 항목을 삭제합니다.
실용적인 작업 흐름은 /를 눌러 검색하고, j와 k로 결과를 탐색하며, x로 관련 항목을 표시한 다음, 모든 경로를 확인한 후에만 삭제하는 것입니다.
인터페이스 테마 변경
테마 메뉴를 열어 사용 가능한 스킨 사이를 전환하세요. 기본적으로 Carbon이 선택되어 있습니다. 테마를 변경해도 인터페이스의 모양만 바뀌며, 검색된 스킬이나 해당 파일은 변경되지 않습니다.
로컬에서 Skill Cabinet 개발
소스 코드 작업을 하려면 저장소를 복제하고 종속 항목을 설치하세요.
git clone git@github.com:subsy/skill-cabinet.git
cd skill-cabinet
npm install
npm run dev그런 다음 브라우저에서 http://127.0.0.1:5173을 여세요.
프로덕션 빌드 실행
다음 명령으로 애플리케이션을 빌드하고 프로덕션 모드에서 시작하세요.
npm run build
npm start저장소 기여자는 프로젝트의 기여 지침을 확인하려면 CONTRIBUTING.md를 참조해야 합니다.
고급 팁
- 삭제 전에 검사하세요: 의도한 디렉터리를 선택했는지 확인하려면 경로, 소스, 프런트매터 및 추가 파일을 점검하세요.
- 필터링과 검색을 함께 사용하세요: 먼저 서랍을 선택한 다음, 범위가 좁혀진 카탈로그에서 이름, 설명, 경로 또는 메타데이터로 검색하세요.
- 일괄 정리에는 표시 기능을 사용하세요:
x로 여러 항목을 표시하되,d를 누르기 전에 전체 목록을 확인하세요. - 현재 브라우저 상태를 유지하세요: 시작 시 인터페이스가 자동으로 열리지 않게 하려면
SKILL_CABINET_NO_OPEN=1을 사용하세요. - 포트 충돌을 피하세요: 포트
3781이 이미 사용 중이면 다른PORT값으로 애플리케이션을 시작하세요. - 관리되는 스킬은 다시 나타날 수 있습니다: 이후 도구 업데이트로 Cursor 기본 제공 스킬과 플러그인 캐시 사본이 복원될 수 있습니다.
결론
Skill Cabinet은 여러 도구 디렉터리에 흩어진 에이전트 스킬을 검색하고 검토할 수 있는 집중형 로컬 인터페이스를 제공합니다. 검색 가능한 메타데이터, 소스 및 렌더링 보기, 폴더 검사, 테마, 키보드 조작, 일괄 삭제 기능을 통해 로컬 스킬 관리를 간소화합니다. 삭제는 되돌릴 수 없으므로 제거하기 전에 검사 도구를 사용해 각 스킬을 확인하세요.
Skill Cabinet은 MIT 라이선스로 배포됩니다.