npx-skills について
`npx skills` コマンドラインによるエージェントスキルのインストールと管理を説明するスキルです。Claude Code のプロジェクト配置と、ロックファイルを使った不足スキルの検出を扱います。
主な機能
- 01`npx skills add` によるスキルのインストール
- 02`skills-lock.json` へのプロジェクトスキル記録
- 03ロックファイルに基づく不足スキルの検出
- 04プロジェクト単位とグローバルの配置
- 05コピー方式によるファイル更新
活用シーン
- 01Claude Code プロジェクトへのスキル導入
- 02ロックファイル記載スキルの不足確認
- 03インストール済みスキルファイルの更新
- 04プロジェクト単位かグローバルかの選択
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/npx-skillsを入力して読み込まれたか確認します。
詳細
npx-skills
npx skills CLI
(https://github.com/vercel-labs/skills)
は、GitHub のソースからエージェントスキルをホストプロジェクトの
.claude/skills/ ディレクトリにインストールし、
インストールした内容を記録するプロジェクトレベルの skills-lock.json を書き込みます。
ロックファイル
| ファイル | スコープ | チェックイン | スキルごとのフィールド |
|---|---|---|---|
skills-lock.json（リポジトリルート） | プロジェクト | はい | source、sourceType、skillPath、computedHash |
~/.agents/.skill-lock.json | グローバル | いいえ | -g を使用したときに書き込まれる |
プロジェクトのロックファイルは、リポジトリに存在することが想定されるスキルの信頼できる情報源です。
起動時の検出
リポジトリルートに skills-lock.json があるものの .claude/skills/ ディレクトリがないプロジェクト（または、ディレクトリはあるものの、ロックファイルに記載されたスキルが不足しているプロジェクト）での最初のやり取りでは、次の手順を実行します。
-
skills-lock.jsonを読み込み、.claude/skills/に存在しないskills.*配下のスキル名を一覧表示します。 -
それらのエントリから、重複のない
sourceの値を収集します。 -
不足しているスキルをユーザーに伝え、 ソースごとに1つのインストールコマンドを提案します。
npx skills add <source> --skill '*' --copy -a claude-code -y -
何かを実行する前に、ユーザーの確認を待ちます。
ユーザーが ~/.claude/skills/ へのインストールを明示的に希望した場合に限り、プロジェクトローカルのデフォルトの代わりに -g を使用します。
インストール — ソースのすべてのスキル
npx skills add <owner/repo> --skill '*' --copy -a claude-code -y
--skill '*'— ソース内のすべてのスキルです。 1つのスキルを指定する場合は、--skill <name>に置き換えます。--copy— シンボリックリンクではなく、通常のファイルコピーを書き込みます。 シンボリックリンクを使うと、ホストリポジトリがソースのチェックアウトに結び付けられ、利用側のgit statusが煩雑になります。-a claude-code— Claude Code の.claude/skills/レイアウトを対象にします。-y— 非対話モードです （スキルごとの確認プロンプトを省略します）。
インストール — 1つのスキル
npx skills add <owner/repo> --skill <skill-name> -a claude-code
1つのスキルを追加するときは -y を省略します —
対話型プロンプトはすぐに完了し、
解決されたソースを確認できます。
更新 — add --copy -y を再実行
--copy -y を指定してインストールを再実行すると、.claude/skills/ 内の既存ファイルがその場で上書きされるため、インストールと更新には同じコマンドを使用できます。
npx skills add <owner/repo> --skill '*' --copy -a claude-code -y
npx skills update を避ける
update はホストリポジトリの .agents/ にパッケージをステージングするため、利用側プロジェクトの git status が煩雑になります。
--copy フラグを指定しても変わりません —
update はこのフラグを受け付けますが、何も通知せず無視します。
代わりに add --copy -y を使用してください。
スコープ：プロジェクトとグローバル
| モード | フラグ | インストール先 |
|---|---|---|
| プロジェクト | （デフォルト） | .claude/skills/ |
| グローバル | -g | ~/.claude/skills/ |
デフォルトかつ推奨されるスコープはプロジェクトです。
upstream に照らした確認
npx skills のドキュメントサイトには詳細があまりありません。
フラグやコマンドの正確な動作が不明な場合は、推測せずに
https://github.com/vercel-labs/skills
のソース（src/add.ts、src/update.ts、src/skill-lock.ts）を読んでください。