ONEDEV

agent-skills

tech-leads-club파일 1,157개

★ 6,317주당 +561조회 8

무엇인가

agent-skills는 검증된 스킬만 모아 배포하는 레지스트리이자 설치 CLI다. 스킬 공급망 보안과 설치 일관성이라는 문제 영역을 규율한다. 개별 스킬은 에이전트가 특정 작업을 수행할 때 따를 절차·패턴·전문 지식을 지침 파일로 고정한다.

어떻게 동작하나

스킬은 packages/skills-catalog/skills/(category-name)/skill/ 경로에 놓인다. 각 스킬 폴더는 SKILL.md(본문 지침), templates/(파일 템플릿), references/(온디맨드 문서)로 구성된다. CLI는 CDN에서 카탈로그(약 45KB)를 받아 사용자가 고른 스킬만 내려받아 ~/.cache/agent-skills/에 캐시하고, 대상 에이전트 설정 디렉터리에 복사 또는 심링크로 설치한다. 설치 결과는 잠금파일과 콘텐츠 해시로 고정되고 감사 로그에 기록된다. MCP 서버(@tech-leads-club/agent-skills-mcp)는 progressive disclosure 방식으로 카탈로그를 노출해 검색 후 필요한 항목만 가져오게 한다.

무엇과 다른가

프롬프트를 직접 쓰거나 단일 CLAUDE.md·AGENTS.md를 두는 방식과 달리, 카테고리별 다중 스킬을 골라 설치하고 갱신·제거를 CLI로 관리한다. 배포 전 정적 분석 CI와 Snyk Agent Scan(구 mcp-scan) 스캔을 거치고, 바이너리 없이 100% 오픈소스로 배포된다. CLI 쪽은 정제·경로 격리·심링크 가드·원자적 잠금파일·감사 추적으로 방어 계층을 둔다.

어떻게 쓰나

설치는 npx @tech-leads-club/agent-skills로 대화형 마법사를 띄운다. 동작 선택(설치/갱신), 카테고리 필터·검색, 대상 에이전트 선택, 복사 또는 심링크, 전역(사용자 홈) 또는 로컬(프로젝트) 범위를 순서대로 고르며 각 단계에서 ← Back으로 되돌릴 수 있다. 비대화형은 agent-skills install -s <skill> -a cursor claude-code, -g(전역), --symlink, --force(캐시 우회) 옵션을 쓰고 list·update·remove·cache·audit·credits 하위 명령으로 관리한다. 전역 설치는 npm install -g @tech-leads-club/agent-skills.

전제와 한계

지원 목록에 있는 에이전트에만 설치되며, 목록에 없으면 이슈로 추가를 요청해야 한다. Node.js와 npx 실행 환경이 필요하다. 카탈로그는 CDN 온디맨드 방식이라 오프라인에서는 캐시된 범위만 쓸 수 있다. 스킬은 지침 파일이므로 에이전트 런타임 자체를 바꾸지 않고, 설치 후 동작은 해당 에이전트가 규칙 파일을 읽는 방식에 의존한다.

관련 논문 2

유사 스킬