概要
オープンなエージェントスキルエコシステムのためのコマンドラインツールで、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)
トラブル対応'skills update' が 'Multiple current paths match' 警告でスキルをスキップする問題の修正方法
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) アップストリームのリポジトリから重複を削除する: 余分なミラーコピーまたはコミットされたシンボリックリンクを削除し、各スキルが正確に1つのパスに解決されるようにします — クローン後に 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 のセキュリティ分析は再スナップショット時に再実行されないため、監査には古いスナップショットの分析結果が引き続き表示される場合があります。