skills – Open‑Agent Skills エコシステム用CLI

概要 – skills は、エージェントスキル を検出、インストール、更新、実行できるコマンドラインツールです（npx または npm でインストール）。スキルとは、SKILL.md ファイルで定義された、コーディングアシスタント（Claude Code、Cursor、Codex、OpenCode など）向けの小さな再利用可能な指示セットです。

重要性 – 最新の AI 搭載コーディングアシスタントは、カスタムプロンプトで拡張できます。skills は、任意の Git リポジトリ（GitHub、GitLab、Azure Repos、または直接 URL）からそれらのプロンプトバンドルを取得し、対象エージェントが期待する場所に配置し、生成されたプロンプトでエージェントを対話的に起動するための統一されたワークフローを提供します。

コアコンセプト

コンセプト	説明
スキル	YAML フロントマター（`name`、`description`）と、エージェントが従うプロンプトテキストを含む `SKILL.md` ファイルを含むディレクトリ。
エージェント	拡張したい AI コーディングアシスタント（例：`claude-code`、`cursor`、`opencode`）。CLI は各エージェントがスキルファイルを保存する場所を認識しています。
スコープ	スキルはプロジェクトローカル（`./<agent>/skills/`）またはグローバル（`~/<agent>/skills/`）にインストールできます。
ソース	スキルは、任意の Git リポジトリ（GitHub の短縮形、完全な URL、GitLab、Azure、SSH、またはローカルフォルダ）または直接ダウンロード URL（zip / tar）から取得されます。

一般的なワークフロー

スキルを見つける – https://skills.sh の公開カタログを閲覧するか、ローカルで検索します：
```
npx skills find web‑design
```
インストール – 目的のエージェントにスキルを取得します：
```
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a claude-code -g -y
```
-g はグローバルにし、-a はエージェントを選択し、-y はプロンプトをスキップします。
インストールせずに使用 – プロンプトを生成して、エージェントに直接パイプします：
```
npx skills use vercel-labs/agent-skills@web-design-guidelines | claude
```
更新 – インストール済みのスキルを最新バージョンに更新します：
```
npx skills update -y
```
削除 – 不要なスキルをクリーンアップします：
```
npx skills remove web-design-guidelines -a claude-code
```

主なコマンド

コマンド	説明
`skills add <source>`	リポジトリまたは URL から 1 つまたは複数のスキルをインストールします。`--skill`、`--agent`、`--global`、`--copy` などをサポートします。
`skills use <source>`	スキルを解決し、生成されたプロンプトを出力するか、選択したエージェントを対話的に起動します（`--agent`）。
`skills list` (`ls`)	現在インストールされているすべてのスキル（プロジェクトまたはグローバル）を表示します。
`skills find [query]`	検出されたスキルを対話的またはキーワード検索します。オプションで GitHub オーナーに限定できます。
`skills update [skills…]`	インストール済みスキルの新しいバージョンを取得します。スコープ指定（`-g`、`-p`）または非対話的に実行（`-y`）できます。
`skills remove [skills…]`	インストール済みスキルを削除します。フラグでエージェント、スコープ、またはすべてを削除できます。
`skills init [name]`	独自のスキルを作成するための新しい `SKILL.md` テンプレートをスキャフォールドします。

サポートされているエージェント（抜粋）

CLI は、claude-code、cursor、codex、opencode などの人気のあるものから、コミュニティがメンテナンスする多くのエージェント（例：aider-desk、astrbot、kilo、zcode）まで、75 以上のエージェント を認識しています。各エージェントには、CLI がシンボリックリンク（デフォルト）またはスキルファイルのコピーを配置する、事前定義されたプロジェクトおよびグローバルディレクトリがあります。

インストールと使用法

# 一度だけ使用 – 永続的なインストールは不要
npx skills add vercel-labs/agent-skills

# npm によるグローバルインストール（オプション）
npm i -g skills

このツールは、既に設定されている Git 認証情報（Git 認証ヘルパー、GitHub CLI、SSH キーなど）に依存しています。プライベートリポジトリの場合は、GITHUB_TOKEN/GH_TOKEN を指定するか、CLI に既存の認証をフォールバックさせることができます。

検討すべきタイミング

チーム全体でプロンプトを標準化 同じコーディングアシスタントを使用する開発者間で。
再利用可能なワークフローの共有（リリースノート生成、PR スキャフォールディング、Linear や Notion などのツールとの統合）。
新しいプロンプトの迅速なプロトタイピング リポジトリにコミットせずに – skills use でその場でテストできます。
CI / CD パイプライン – 非対話フラグ（--yes、--global）により、自動化環境でのスキルインストールが安全です。

制限と考慮事項

CLI は プロンプト ファイルのみを管理します。コードを実行したり、エージェントのランタイムを提供したりしません。
スキル検出は、--full-depth を使用しない限り、3 レベルのディレクトリ深度に制限されます。
大きなダウンロードは、安全性のためにデフォルトで上限（10 MiB）があります。ソースを信頼する場合は、環境変数で制限を引き上げることができます。

TL;DR

skills は、多様な AI コーディングアシスタント向けのプロンプトベースの拡張機能（スキル）を取得、インストール、実行できる軽量なクロスエージェント CLI です。あらゆる Git ホストで動作し、プライベートリポジトリをサポートし、対話的にも CI パイプラインでも使用できます。

vercel-labs/skills