skills-cli

このスキルは、skills CLI を使用して、オープンな Agent Skills エコシステムをユーザーが利用できるよう支援します。

概要

skills CLI は、インストール可能な Agent Skills のパッケージマネージャーです。スキルの検索、適切なフラグを指定したインストール、インストール後の管理に使用します。

以下の例では bunx skills を使用していますが、ユーザーの環境で Bun が利用できない場合は、同じ手順で npx skills を使用できます。

常に現在の CLI 構文を優先してください。

bunx skills add <source> --skill <name>

古い owner/repo@skill-name の例は使用しないでください。

使用するタイミング

次の場合にこのスキルを使用します。

• ユーザーが「X 用のスキルを探して」「X 用のスキルはありますか」「X はどうすればできますか」と尋ねており、X が再利用可能なワークフローと思われる場合
• ユーザーが「X をできますか」と尋ねており、X がすでにスキルとして存在する可能性のある専門的な機能と思われる場合
• bunx skills、npx skills、skills.sh、スキルパッケージのインストール、skills-lock.json について支援を求めている場合
• Codex や OpenCode など、特定のエージェント向けにスキルをインストールしたい場合
• インストール済みスキルの一覧表示、確認、更新、削除、復元、同期、バックアップ、初期化を希望している場合
• デザイン、テスト、デプロイ、ドキュメント作成、コードレビューなど、ワークフロー、ツール、テンプレート、ドメイン固有の機能の検索について支援を求めている場合

ユーザーがすでにローカルスキルを持っており、その内容の作成や改善を希望している場合は、このスキルを使用しないでください。その場合は、スキル作成のワークフローを使用してください。

検索ワークフロー

ユーザーがスキルを必要としている場合は、次の手順に従います。

1. ドメインとタスクを特定します。 例：React のパフォーマンス、PR レビュー、変更履歴の生成、PDF からの抽出。 また、そのタスクが一般的で、再利用可能なスキルが存在する可能性が高いかどうかも判断します。
2. まず skills.sh を確認します。 そのドメインがすでに掲載されている場合は、よく知られ、広くインストールされているスキルを優先します。
3. ランキングだけではニーズを明確に判断できない場合は、次のコマンドで検索します。

bunx skills find <query>

1. 推薦する前に品質を確認します。
   • インストール数：1K 以上のスキルを優先し、100 未満のものには注意します
   • 提供元の信頼性：openai、anthropics、microsoft などの公式または確立されたメンテナー、あるいは同様に信頼できる提供元を優先します
   • リポジトリの品質：ソースリポジトリを確認し、スターが 100 未満のリポジトリのスキルは慎重に扱います
2. 選択肢をわかりやすく提示します。 スキル名、役立つ用途、インストール数と提供元、信頼できると判断した理由、インストールコマンド、詳細を確認できる skills.sh のリンクを含めます。
3. ユーザーが希望する場合は、インストールを支援します。
4. 適切なスキルが見つからない場合は、その旨を明確に伝え、一般的な能力を活用してタスクを支援します。また、ユーザーが bunx skills init で独自のパッケージを作成できることも伝えます。

インストールのクイックリファレンス

一般的なソース

# GitHub shorthand
bunx skills add xixu-me/skills

# Full GitHub URL
bunx skills add https://github.com/xixu-me/skills

# Direct path to one skill inside a repo
bunx skills add https://github.com/xixu-me/skills/tree/main/skills/skills-cli

# GitLab URL
bunx skills add https://gitlab.com/org/repo

# Any git URL
bunx skills add [email protected]:owner/repo.git

# Local package path
bunx skills add ./my-local-skills

一般的なインストールパターン

# List skills in a package without installing
bunx skills add <source> --list

# Install one skill
bunx skills add <source> --skill skills-cli

# Install multiple skills
bunx skills add <source> --skill pr-review --skill commit

# Install globally
bunx skills add <source> --skill skills-cli -g -y

# Install to a specific agent
bunx skills add <source> --skill skills-cli -a codex -y

# Install all skills to all agents
bunx skills add <source> --all

# Install all skills to one agent
bunx skills add <source> --skill '*' -a codex -y

# Copy files instead of symlinking
bunx skills add <source> --skill skills-cli -a codex --copy -y

インストール方法

ユーザーがインストール方法を選ぶ際は、次の点を考慮します。

• シンボリックリンクはデフォルトであり、更新を一元管理できるため、通常は最適な選択肢です
• --copy は独立したコピーを作成します。シンボリックリンクがサポートされていない場合や、不便な場合の代替手段です

ユーザーがスキルのインストールだけを希望している場合は、CI パッケージング、可搬性、ファイルシステムの制約に言及しているか、明示的にコピーを求めている場合を除き、デフォルトのシンボリックリンク方式を優先します。

重要なフラグ

フラグ	用途
--skill <name>	名前を指定して 1 つ以上のスキルをインストールします
-a, --agent <agent>	codex など、対象とするエージェントを指定します
-g, --global	プロジェクト単位ではなく、ユーザー単位でインストールします
-y, --yes	プロンプトをスキップします
--list	パッケージ内で利用可能なスキルを一覧表示します
--copy	シンボリックリンクの代わりにコピーします
--all	すべてのスキルをすべてのエージェントにインストールする省略形です

インストール済みスキルの管理

継続的なメンテナンスには、次のコマンドを使用します。

# List installed skills
bunx skills ls
bunx skills ls -g
bunx skills ls -a codex
bunx skills ls --json

# Check for updates
bunx skills check

# Update installed skills
bunx skills update

# Remove installed skills
bunx skills remove my-skill
bunx skills remove my-skill -a codex
bunx skills remove -g my-skill
bunx skills remove --all

# Initialize a new skill package
bunx skills init
bunx skills init my-skill

# Restore from skills-lock.json
bunx skills experimental_install

# Sync node_modules skills into agent directories
bunx skills experimental_sync
bunx skills experimental_sync -a codex -y

ユーザーからスキルの初期化を求められた場合は、次のどちらを希望するか確認してください。

• bunx skills init は、現在のディレクトリに SKILL.md を作成します
• bunx skills init <name> は、SKILL.md を含む新しいサブディレクトリを作成します

関連ツール：Skills Vault

インストール済みスキルをマシン間またはチーム間で宣言的にバックアップ・復元したい場合は、Skills Vault を使用してください。

Skills Vault は、skills エコシステム向けの独立した CLI 補助ツールです。skills add でインストールできるスキルソースではありません。インストール済みスキルをマニフェストにスナップショットとして保存したい場合、復元コマンドを事前に確認したい場合、または別の場所で同じセットアップを再現したい場合に使用してください。

よく使う補助コマンド：

# Back up installed skills into skvlt.yaml
bunx skvlt backup

# Preview a restore
bunx skvlt restore --dry-run

# Restore everything from the manifest
bunx skvlt restore --all

# Diagnose the local environment
bunx skvlt doctor

ユーザーがポータブルなマニフェストのワークフロー、マシン間のバックアップと復元、またはインストール済みスキルのセットアップのチーム共有を明示的に希望している場合は、skills experimental_* よりもこのツールを優先してください。

推薦フォーマット

スキルを推薦するときは、具体的でインストール可能な内容にしてください。

次のような構成を使用します。

I found a skill that should fit.

Skill: <skill-name>
Why it matches: <one sentence>
Source: <owner/repo or URL>
Quality check: <install count / source reputation / repository confidence note>
Install:
bunx skills add <source> --skill <skill-name> [optional flags]
Learn more: https://skills.sh/<publisher>/<package>/<skill-name>

If you want, I can install it for <agent-or-scope>.

ユーザーが対象のエージェントまたはスコープに言及している場合は、コマンドに含めてください。例：

bunx skills add <source> --skill <skill-name> -a codex -y
bunx skills add <source> --skill <skill-name> -g -y

例：

I found a skill that might help.

Skill: screenshot
Why it matches: it focuses on OS-level desktop and window screenshot capture.
Source: openai/skills
Quality check: high install volume, trusted publisher, and a widely used source repository.
Install:
bunx skills add openai/skills --skill screenshot
Learn more: https://skills.sh/openai/skills/screenshot

よくあるスキルのカテゴリ

ユーザーの表現が曖昧な場合は、該当しそうなカテゴリに対応付けてください。

カテゴリ	クエリの例
Web 開発	react、nextjs、typescript、css、tailwind
テスト	testing、jest、playwright、e2e
DevOps	deploy、docker、kubernetes、ci-cd
ドキュメント	docs、readme、changelog、api-docs
コード品質	review、lint、refactor、best-practices
デザイン	ui、ux、design-system、accessibility
生産性	workflow、automation、git

検索のヒント

• 具体的なキーワードを使います。testing だけよりも、react testing の方が適しています。
• 別の用語も試します。deploy で見つからない場合は、deployment や ci-cd を試してください。
• まず人気のあるソースを確認します。実績のある公開元には、優れたスキルが数多くあります。
• 最初の検索範囲が広すぎる場合は、ドメインとタスクを組み合わせて絞り込みます。

よくある間違い

• 検索結果にあるスキルが信頼できるものかを確認せずに推薦する。
• ユーザーが特定のエージェントを指定した場合に、-a <agent> の指定を忘れる。
• bunx skills find --help を実際のヘルプコマンドとして扱う。コマンドのヘルプには、代わりに bunx skills --help を使用してください。
• 検索語を一度試しただけでスキルが存在しないと判断する。まず、より具体的な検索語や関連するクエリを試してください。

トラブルシューティング

ユーザーがエラーや分かりにくい結果に遭遇した場合：

• 「スキルが見つかりません」—より適切なクエリを提案し、skills.sh を確認するか、直接サポートして bunx skills init について説明します
• 自動化または CI で対話型プロンプトが表示される — -y を追加します
• インストールスコープが間違っている — プロジェクトへのインストールと -g を切り替えます
• シンボリックリンクの問題 — --copy を付けて再試行します
• 利用可能なパッケージの内容が不明 — bunx skills add <source> --list を実行します
• インストール状態が不明 — bunx skills ls または bunx skills ls --json を実行します
• マシン間でのポータブルなバックアップまたは復元 — Skills Vault と、その backup / restore --dry-run のワークフローを案内します

正確なフラグが分からない場合は、次を使用します。

bunx skills --help