skills CLI
npx skills — オープンなエージェントスキルエコシステムの CLI
何か
skills は AI コーディングエージェント向けのスキル管理 CLI。GitHub リポジトリや URL、ローカルパスからスキルをインストールし、Claude Code・Cursor・Codex など 40 以上のエージェントが使えるディレクトリへシンリンク（または コピー）で配置する。
40+対応エージェント
v1.4最新バージョン
MITライセンス
TS実装言語
スキルとは？
SKILL.md ファイルで定義された再利用可能な指示セット。AI エージェントが特定タスク（PR 作成・リリースノート生成・外部連携など）を実行する手順を含む。Agent Skills 仕様 に準拠。
主要コマンド
| コマンド | 説明 | エイリアス |
|---|---|---|
skills add <pkg> | Git リポジトリ・URL・ローカルパスからスキルをインストール | skills a |
skills list | インストール済みスキルを一覧表示 | skills ls |
skills find [query] | スキルをインタラクティブまたはキーワードで検索 | — |
skills remove [skills] | エージェントディレクトリからスキルを削除 | skills rm |
skills check | インストール済みスキルの更新を確認 | — |
skills update | 全スキルを最新版に更新 | — |
skills init [name] | 新しい SKILL.md テンプレートを生成 | — |
よく使うオプション（add）
| オプション | 説明 |
|---|---|
-g, --global | プロジェクトではなくユーザーディレクトリへインストール |
-a, --agent <agents> | インストール先エージェントを指定（例: claude-code cursor） |
-s, --skill <skills> | 特定スキルのみインストール（'*' で全部） |
-l, --list | インストールせずにリポジトリ内スキルを一覧表示 |
--copy | シンリンクの代わりにコピーで配置 |
-y, --yes | 確認プロンプトをすべてスキップ（CI/CD 向け） |
--all | --skill '*' --agent '*' -y の省略形 |
モジュール構成
エントリポイント cli.ts がコマンドをルーティングし、各機能モジュールが独立して動作する。スキルのインストールはシンリンク方式が推奨で、単一の正規コピーを複数エージェントが共有する。
flowchart TD
CLI["cli.ts\nエントリポイント"] --> ADD["add.ts\nスキル追加"]
CLI --> LIST["list.ts\n一覧表示"]
CLI --> FIND["find.ts\n検索"]
CLI --> REMOVE["remove.ts\n削除"]
CLI --> INIT["init.ts\nテンプレ生成"]
CLI --> CHECK["cli.ts\ncheck / update"]
ADD --> SRC["source-parser.ts\nURL・パス解析"]
ADD --> GIT["git.ts\nクローン操作"]
ADD --> INST["installer.ts\nシンリンク / コピー"]
ADD --> AGENT["agents.ts\nエージェント定義"]
INST --> LOCK["skill-lock.ts\nグローバルロック\n~/.agents/.skill-lock.json"]
INST --> LLOCK["local-lock.ts\nローカルロック\nskills-lock.json"]
ADD --> PROV["providers/\nGitHub / HuggingFace\nRegistry"]
ADD --> PLUG["plugin-manifest.ts\nClaude Plugin 互換"]
classDef entry fill:#f97316,color:#fff,stroke:none
classDef cmd fill:#fed7aa,color:#431407,stroke:none
classDef core fill:#bfdbfe,color:#1e3a5f,stroke:none
classDef store fill:#bbf7d0,color:#14532d,stroke:none
class CLI entry
class ADD,LIST,FIND,REMOVE,INIT,CHECK cmd
class SRC,GIT,INST,AGENT,PROV,PLUG core
class LOCK,LLOCK store
src/ ディレクトリ構成
| ファイル | 役割 |
|---|---|
cli.ts | メインエントリポイント。コマンドルーティング・init/check/update |
add.ts | add コマンドの核。インタラクティブ選択からインストールまで一連を担う |
source-parser.ts | GitHub shorthand・フル URL・GitLab URL・ローカルパスを解析 |
installer.ts | シンリンク / コピーでスキルをエージェントディレクトリへ配置。インストール済みスキルの列挙も担当 |
agents.ts | 40+ エージェントの定義・検出ロジック（project/global パス） |
skill-lock.ts | グローバルロックファイル管理。GitHub Trees API で更新チェック（SHA 比較） |
local-lock.ts | プロジェクトローカルロック（skills-lock.json）管理。チームで共有可能 |
skills.ts | スキルの探索とパース（YAML frontmatter: name / description） |
providers/ | GitHub・HuggingFace・Registry など外部プロバイダの抽象化 |
plugin-manifest.ts | Claude Code プラグインマーケットプレイスとの互換対応 |
ソース形式
skills add は複数のソース形式を受け付ける。
GitHub shorthand
npx skills add vercel-labs/agent-skills
フル URL
npx skills add https://github.com/org/repo
特定スキルへのパス
npx skills add org/repo/tree/main/skills/foo
ローカルパス
npx skills add ./my-local-skills
よく使うコマンド例
# リポジトリ内スキルを確認（インストールなし）
npx skills add vercel-labs/agent-skills --list
# 特定スキルだけ Claude Code へグローバルインストール（非対話）
npx skills add vercel-labs/agent-skills --skill frontend-design -g -a claude-code -y
# 全スキルを全エージェントへ
npx skills add vercel-labs/agent-skills --all
# インストール済み一覧
npx skills list
# 更新チェック
npx skills check
# 全スキルを最新化
npx skills update
インストールスコープ
| スコープ | フラグ | 配置先 | 用途 |
|---|---|---|---|
| プロジェクト | （デフォルト） | ./{agent}/skills/ | リポジトリにコミット、チームで共有 |
| グローバル | -g | ~/{agent}/skills/ | 全プロジェクトで利用可能 |
主要エージェント
以下は特によく使われるエージェント（2026年3月時点 40+ 対応）。CLI はインストール済みエージェントを自動検出する。
claude-code
cursor
codex
opencode
windsurf
gemini-cli
github-copilot
amp
cline
roo
augment
openhands
goose
junie
kilo
kiro-cli
qwen-code
trae
zencoder
... and more
エージェント別インストールパス
| エージェント | --agent 値 | プロジェクトパス |
|---|---|---|
| Claude Code | claude-code | .claude/skills/ |
| Cursor | cursor | .agents/skills/ |
| Codex | codex | .agents/skills/ |
| OpenCode | opencode | .agents/skills/ |
| Windsurf | windsurf | .windsurf/skills/ |
| Augment | augment | .augment/skills/ |
| Goose | goose | .goose/skills/ |
シンリンク（推奨）: 1 つの正規コピーを全エージェントが共有。更新時は 1 か所変更するだけ。
--copy はシンリンク非対応環境向け。
最小構成
スキルは SKILL.md ファイルを含むディレクトリ。YAML frontmatter に name と description が必須。
---
name: my-skill
description: このスキルの目的と使うタイミング
---
# My Skill
エージェントが実行する手順をここに記述する。
## いつ使うか
このスキルを呼び出すシナリオを説明する。
## 手順
1. まずこれをする
2. 次にこれをする
オプションフィールドと探索パス
| フィールド | 説明 |
|---|---|
name | 一意の識別子（小文字・ハイフン可）— 必須 |
description | スキルの概要（いつ・なぜ使うか）— 必須 |
metadata.internal: true | 通常の探索から非表示。INSTALL_INTERNAL_SKILLS=1 で表示 |
スキル探索パス
CLI はリポジトリ内の以下のパスを自動探索する（代表例）。
skills/
.claude/skills/
.agents/skills/
.windsurf/skills/
.cursor/skills/
.goose/skills/
... 30+ パス
標準パスにスキルが見つからない場合はリポジトリ全体を再帰探索する。
新しいスキルを作る
# カレントディレクトリに SKILL.md を生成
npx skills init
# サブディレクトリに新スキルを作成
npx skills init my-skillスキルを公開する場合は skills.sh のディレクトリに登録できる。
公式・関連
- GitHub: vercel-labs/skills — 本体リポジトリ（TypeScript）
- skills.sh — スキルディレクトリ（公開スキルの検索・登録）
- Agent Skills 仕様（agentskills.io） — 仕様書
- Claude Code Skills ドキュメント
- Cursor Skills ドキュメント
- OpenCode Skills ドキュメント
- vercel-labs/agent-skills — Vercel 公式スキル集