개요
오픈 에이전트 스킬 생태계를 위한 CLI 도구로, Claude Code, Codex, Cursor, OpenCode 등 다양한 AI 에이전트를 지원합니다. GitHub, GitLab, Git 주소, 로컬 경로 또는 직접 다운로드 링크에서 스킬을 설치할 수 있으며, 심볼릭 링크 또는 복사 방식을 지원하고, 검색, 업데이트, 제거, 목록 조회 및 스킬 템플릿 생성 등의 명령을 제공합니다.
README 미리보기
# skills\n\nThe CLI for the open agent skills ecosystem.\n\n\nSupports **OpenCode**, **Claude Code**, **Codex**, **Cursor**, and [75 more](#supported-agents).\n\n\n[](https://skills.sh/vercel-labs/skills)\n\n## Install a Skill\n\n```bash\nnpx skills add vercel-labs/agent-skills\n```\n\n## Use a Skill Without Installing\n\nGenerate a prompt for one skill, or start a supported coding agent interactively:\n\n```bash\nnpx skills use vercel-labs/agent-skills@web-design-guidelines | claude\nnpx skills use vercel-labs/agent-skills --skill web-design-guidelines --agent claude-code\n```\n\n`skills use` resolves sources the same way as `skills add`, writes the selected skill files to a temporary directory, and prints only the generated prompt to stdout unless `--agent` is provided. With `--agent`, it starts one supported agent interactively with the generated prompt.\n\n### Source Formats\n\n```bash\n# GitHub shorthand (owner/repo)\nnpx skills add vercel-labs/agent-skills\n\n# Full GitHub URL\nnpx skills add https://github.com/vercel-labs/agent-skills\n\n# Direct path to a skill in a repo\nnpx skills add https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines\n\n# GitLab URL\nnpx skills add https://gitlab.com/org/repo\n\n# Any git URL\nnpx skills add git@github.com:vercel-labs/agent-skills.git\n\n# Local path\nnpx skills add ./my-local-skills\n```\n\n### Private Repositories\n\nUse the same command for public and private repositories. The CLI uses the authentication already configured for the repository URL:\n\n```bash\n# GitHub shorthand or HTTPS (Git credential helper, GitHub CLI, then SSH fallback)\nnpx skills add acme/private-skills\n\n# SSH on GitHub, GitLab, or another Git host\nnpx skills add git@github.com:acme/private-skills.git\nnpx skills add ssh://git@git.example.com/acme/private-skills.git\n\n# HTTPS on any Git host (uses your configured Git credential helper)\nnpx skills add https://git.example.com/acme/private-skills.git\n```\n\nFor G
FAQ (2)
문제 해결'Multiple current paths match' 경고로 인해 'skills update'가 스킬을 건너뛰는 문제를 해결하는 방법?
skills CLI의 알려진 버그(1.5.26부터 1.7.0까지 확인됨): resolveSkillLocations에서 모호성 검사(candidates.length > 1)가 skills-lock.json에 저장된 정규 경로(lockSkills[name].skillPath)가 업스트림에 여전히 존재하는지 확인하기 전에 실행됩니다. 이 버그는 리포지토리가 여러 디렉터리에 동일한 스킬을 포함하는 경우(예: skills/<name>/SKILL.md와 .openclaw/skills/<name>/SKILL.md) 또는 커밋된 심볼릭 링크를 통해 중복을 노출하는 경우(예: .claude/skills -> ../skills)에 발생합니다. 수정 사항(PR #2231)이 배포될 때까지의 해결 방법: 1) 설치된 CLI에 패치 적용 — dist/cli.mjs에서 잠긴 경로를 먼저 확인하고, 해당 경로가 업스트림에 더 이상 존재하지 않는 경우에만 모호성을 표시합니다: const normalizedLockedPath = normalizeSkillPath(lockedPath); if (discoveredPaths.has(normalizedLockedPath)) { resolvedPaths.set(name, normalizedLockedPath); continue; } 그런 다음 candidates.length > 1을 평가하고(ambiguousSkills에 푸시), candidates.length === 1을 평가하며(해석), 둘 다 아니면 삭제된 것으로 처리합니다. 2) 업스트림 리포지토리에서 중복 제거: 추가로 미러링된 복사본이나 커밋된 심볼릭 링크를 삭제하여 각 스킬이 정확히 하나의 경로로 해석되도록 합니다 — 클론 후 find -L . -name SKILL.md로 확인하세요. 3) 둘 다 제어할 수 없다면 패치된 릴리스가 나올 때까지 해당 소스의 업데이트를 건너뛰세요.
문제 해결SKILL.md를 업데이트했는데도 skills.sh 스킬 페이지에 여전히 이전 콘텐츠가 표시되는 이유는 무엇이며, 재인덱싱을 강제로 실행하려면 어떻게 해야 하나요?
skills.sh는 인덱싱된 스냅샷을 캐시하며 설치할 때마다 다시 가져오지 않습니다. 관찰된 동작: 저장된 스냅샷 시점으로부터 약 2시간 이내에 이루어진 설치는 스냅샷을 갱신하지 않지만, 며칠 후에 이루어진 텔레메트리 활성화 설치는 현재 기본 브랜치에서 재스냅샷을 트리거합니다(페이지와 https://skills.sh/api/download/<owner>/<repo>/<skill>이 약 10분 이내에 업데이트됨). 해결/우회 방법: 1) 마지막 스냅샷 이후 약 2시간의 캐시 기간이 충분히 지날 때까지 기다립니다. 2) 텔레메트리 활성화 설치를 실행합니다: npx skills@latest add <owner>/<repo> --skill=<skill-name>. 3) api/download URL과 공개 스킬 페이지에서 업데이트된 스냅샷을 확인합니다. 메인테이너의 조치나 수동 리인덱스 요청은 필요하지 않습니다. 주의 사항: /tele/audit 보안 분석은 재스냅샷 시 다시 실행되지 않으므로, 감사 결과에는 여전히 이전 스냅샷의 분석이 표시될 수 있습니다.