skills (vercel-labs/skills)
- 추천0
- GitHub 별40K
- 개발라이선스MIT
에이전트 스킬을 찾고 · 설치하고 · 업데이트하는 `npx skills` CLI. Claude Code · Codex · Cursor 등 80여 에이전트를 지원해요
요약
에이전트 스킬을 찾고 · 설치하고 · 업데이트하는 `npx skills` CLI. Claude Code · Codex · Cursor 등 80여 에이전트를 지원해요
설명
skills
오픈 에이전트 스킬 생태계를 위한 CLI예요.
에이전트 스킬은 코드 리뷰부터 특정 라이브러리 쓰는 법까지, 코딩 에이전트에게 일하는 방법을 가르치는 재사용 가능한 지침이에요. 스킬은 skills.sh에서 찾아보세요.
OpenCode, Claude Code, Codex, Cursor, 그리고 75개 더를 지원해요.
스킬 설치하기
Node.js 22.20 이상이 필요해요. 프로젝트 폴더에서 실행하세요.
npx skills add vercel-labs/agent-skills
설치할 스킬과 코딩 에이전트를 고르세요. 스킬은 기본으로 현재 프로젝트에 설치되고, -g를 붙이면 모든 프로젝트에서 쓸 수 있어요.
# Choose one skill and agent
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a claude-code
# Browse available skills
npx skills find
소스 형식, 비공개 저장소, 전체 옵션은 설치 레퍼런스를 보세요.
다른 명령
| 명령 | 설명 |
|---|---|
npx skills find [query] | 스킬 검색 |
npx skills list | 설치된 스킬 목록 |
npx skills use <source>@<skill> | 설치 없이 스킬 하나 쓰기 |
npx skills check | 사용할 수 있는 업데이트 확인 |
npx skills update [skills...] | 설치된 스킬 업데이트 |
npx skills remove [skills...] | 설치된 스킬 지우기 |
npx skills init [name] | 스킬 틀 만들기 |
예시와 옵션은 CLI 레퍼런스를 읽거나 npx skills --help를 실행하세요. 실험 기능 명령은 아래에 있어요.
설치 없이 스킬 쓰기
스킬의 프롬프트를 만들거나, 지원하는 코딩 에이전트를 그 스킬과 함께 실행해요.
npx skills use vercel-labs/agent-skills@web-design-guidelines --agent claude-code
--agent를 빼면 프롬프트만 출력해요. skills use를 보세요.
실험 기능
experimental_로 시작하는 명령은 미리 보기예요. 이름 · 옵션 · 동작은 예고 없이 바뀌거나 어느 릴리스에서든 사라질 수 있어요.
| 명령 | 설명 |
|---|---|
npx skills experimental_sync | npm 의존성이 함께 담고 온 스킬을 프로젝트에 동기화 |
npx skills experimental_install | skills-lock.json에 기록된 프로젝트 스킬 복원 |
일부 npm 패키지는 코드와 함께 에이전트용 지침도 담고 있어요. sync는 그 지침을 프로젝트에 연결해서 의존성과 함께 업데이트되게 하고, package.json에 선언된 스킬 팩도 설치해요.
npm install -D skills agent-browser
npx skills experimental_sync -y
옵션, skills 필드, 그 배경인 RFC는 실험 명령 레퍼런스를 보세요.
잠금 파일 내용 해시
skills-lock.json(버전 2)는 프로젝트 스킬마다 computedHash를 기록해요. 이 해시는 CLI가 .agents/skills/<name>에 설치하는 파일을 대상으로 해서, list · check · install --frozen-lockfile이 디스크에 있는 파일과 견주어 볼 수 있어요. 스킬을 직접 검사하는 도구도 같은 값을 계산할 수 있어요.
- 스킬 폴더의 모든 파일을 모으세요. 설치 프로그램이 복사하지 않으니
metadata.json파일과.git,__pycache__,__pypackages__폴더는 빼세요. 심볼릭 링크는 가리키는 파일 또는 폴더로 쳐요. 깨지거나, 순환하거나, 스킬 폴더 밖을 가리키는 심볼릭 링크는 빼세요. - 각 파일에 스킬 폴더 기준의 상대 경로를 주고, 구분자는
/를 쓰세요. - 텍스트 파일(NUL 바이트가 없는 파일)은 CRLF를 모두 LF로 바꾸세요. 바이너리 파일은 바꾸지 마세요.
- 파일을 경로의 UTF-8 바이트 순서로 정렬하세요. 로케일을 따르는 정렬은 쓰지 마세요.
- 그 순서대로 각 파일에 대해
path, NUL 바이트, 내용 길이(바이트 수, 10진 ASCII), NUL 바이트, 내용을 하나의 SHA-256에 차례로 넣으세요. 내용 길이는 3단계를 거친 뒤의 값이에요. - 해시는 소문자 16진수 다이제스트예요.
시험 값:
| 파일 | computedHash |
|---|---|
| 없음 | e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 |
SKILL.md = # hi\n | 93c36952d8843b33e68ae970ebabcc03e1687c9bb0dd1ecaf357060318952f55 |
SKILL.md = a\n, docs/b.md = b\n | b22c4d22aa319d2924312fa18fcbfedc88fa89c74dbd8f298c683e1caf7b7f24 |
마지막 값은 printf 'SKILL.md\0002\000a\ndocs/b.md\0002\000b\n' | sha256sum과 같아요.
Git 소스인 경우 항목에 스킬이 온 commit도 기록돼요. skills install(--frozen-lockfile이 있든 없든)은 ref의 최신 커밋이 아니라 그 커밋을 가져와요. 그래서 원본 저장소가 바뀌어도 복원한 결과가 computedHash와 계속 맞아요. skills update는 commit을 앞으로 옮기고, commit이 없는 오래된 항목에는 commit을 추가해요. 서버는 SHA로 커밋을 가져오는 것을 허용해야 해요. GitHub와 GitLab은 허용해요.
--rename으로 설치한 스킬은 설치된 모습 그대로 해시해요. SKILL.md의 frontmatter에 새 name이 들어 있어서, 원본 폴더의 해시와 달라요.
버전 1 잠금 파일은 읽을 때 네트워크 없이 업그레이드돼요. 파일이 버전 1 해시와 여전히 맞는 설치된 스킬은 그 파일로 새 해시를 계산해요. 그 밖의 항목은 대조할 믿을 만한 값이 없어서 빈 해시를 받아요. skills install이 그 스킬을 다시 가져와 새 해시를 기록할 때까지 --frozen-lockfile은 실패해요.
지원하는 에이전트
CLI는 설치된 에이전트를 감지하고, 스킬을 어디에 설치할지 고르게 해 줘요. 지원하는 모든 에이전트, 설치 경로, 호환성을 보세요.
스킬 만들기
npx skills init my-skill
만들어진 SKILL.md에 에이전트용 지침을 적으세요. 형식과 탐색 규칙은 스킬 만들기와 나눠 쓰기를 보세요.
문서
- CLI 레퍼런스: 설치, 명령 예시, 실험 기능
- 지원하는 에이전트: 에이전트 이름, 스킬 폴더, 호환성
- 스킬 만들기: frontmatter, 저장소 구조, 플러그인
- 문제 해결과 설정: 흔한 문제, 환경 변수, 원격 측정
- 프로그램 API:
import { installSkills } from 'skills'로 내 도구에서 스킬 설치 · 관리
원격 측정
CLI는 익명 사용 데이터를 모아요. 원격 측정과 보안 감사 요청을 끄려면 DISABLE_TELEMETRY=1 또는 DO_NOT_TRACK=1을 설정하세요. 무엇을 모으는지는 문서에 있어요.
관련 링크
라이선스
이 프로젝트는 MIT 라이선스로 공개돼요.
링크
평점
- 5점
- 0
- 4점
- 0
- 3점
- 0
- 2점
- 0
- 1점
- 0