agent-skills

AI コーディングエージェントの作業を再利用可能な手順としてまとめた、Agent Skills のコレクションです。このリポジトリは Agent Plugins 1.0.0 に準拠したプラグインでもあり、対応クライアントからまとめてインストールできます。

プロパティベーステストの生成、リファクタリング、Pull Request の作成・再レビューなど、日常的な開発作業に使えるスキルを収録しています。

クイックスタート

プラグインとしてまとめて入れる

収録スキルをまとめて使う場合は、Agent Plugin 対応クライアントからこのリポジトリをインストールします。

# Codex CLI
codex plugin marketplace add nimiusrd/agent-skills
codex plugin add agent-skills@nimiusrd-plugins

# GitHub Copilot CLI
copilot plugin install nimiusrd/agent-skills

• VS Code: Command Palette で Chat: Install Plugin From Source を実行し、https://github.com/nimiusrd/agent-skills を指定します。
• Cursor: Customize からインストールするか、ローカル検証では ~/.cursor/plugins/local/agent-skills にこのリポジトリを配置します。

特定のスキルだけを入れる

個別スキルのインストールには GitHub CLI 2.90.0 以降が必要です。GitHub CLI で認証済みであること（gh auth login）を確認してください。

必要なスキルだけを、現在のプロジェクトのプロジェクトスコープへインストールします。コマンドは対象プロジェクトのルートで実行してください。 非対話環境では利用中のエージェントを自動判定せず、CLIの既定のインストール先が使われる場合があります。インストール後に配置先を確認し、意図したエージェントから利用できることを確認してください。

gh skill install nimiusrd/agent-skills commit-and-pr --scope project

インストール後は、利用するエージェント上で次のように依頼できます。

変更をコミットして PR を作って

収録スキル

各スキルの詳しい動作、制約、対応ツールは、それぞれの SKILL.md を参照してください。

インストール方法

プラグインとしてまとめてインストールする

Agent Plugin 対応クライアントは、ルートの plugin.json を読み、skills/ 直下の各スキルを発見します。

copilot plugin install nimiusrd/agent-skills

VS Code では Chat: Install Plugin From Source、Cursor では Customize または ~/.cursor/plugins/local/agent-skills への配置を使います。

Codex

Codex では、マーケットプレイスを登録してからプラグインをインストールします。

codex plugin marketplace add nimiusrd/agent-skills
codex plugin add agent-skills@nimiusrd-plugins

ローカルの変更を試す場合は、GitHub リポジトリの代わりに、このリポジトリのルートディレクトリを指定します。

codex plugin marketplace add /path/to/agent-skills
codex plugin add agent-skills@nimiusrd-plugins

インストール後は Codex アプリを再起動し、新しいタスクで収録スキルを使用してください。

マーケットプレイス定義は .agents/plugins/marketplace.json にあります。source.path はリポジトリのルートを基準に解決され、./ にある plugin.json と skills/ を参照します。詳細は OpenAI のプラグイン構成ドキュメント を参照してください。

特定のスキルだけをインストールする

リポジトリ名の後にスキル名を指定します。

gh skill install nimiusrd/agent-skills commit-and-pr --scope project

ほかのスキルを指定する場合は、commit-and-pr を収録スキルの名前に置き換えてください。

ローカルのスキルをインストールして検証する

作成中のスキルは、GitHub に公開する前に --from-local で対象プロジェクトへインストールして動作を確認できます。ローカルインストールではファイルがコピーされるため、SKILL.md を修正した場合は再インストールしてください。

1. スキルとプラグインの仕様を検証する

スキルのソースリポジトリで、Agent Skills 仕様と Agent Plugins マニフェストへの適合性を確認します。

cd /path/to/agent-skills
gh skill publish --dry-run
python3 -m pip install --quiet -r requirements-plugin-validate.txt
python3 -m check_jsonschema --schemafile https://agent-plugins.org/schemas/1.0.0/plugin.schema.json plugin.json

2. 作成中のスキルを対象プロジェクトへ入れる

対象プロジェクトのルートで、ローカルリポジトリのパスを指定します。

cd /path/to/target-project

# 1つのスキルだけをインストール
gh skill install /path/to/agent-skills commit-and-pr \
  --from-local --scope project

3. インストール結果を確認して実際に使う

# プロジェクトスコープのスキルと配置先を一覧表示
gh skill list --scope project --json skillName,agentHosts,path

対象プロジェクトでエージェントを起動し、スキルが想定どおり適用される依頼を実行します。

変更をコミットして PR を作って

修正を反映して再確認する場合は、--force を付けて同じコマンドを再実行します。

gh skill install /path/to/agent-skills commit-and-pr \
  --from-local --scope project --force

確認・更新

# インストール済みスキルを一覧表示
gh skill list

# 更新の有無だけ確認
gh skill update --dry-run

# すべてのスキルを更新
gh skill update --all

# インストール前に内容をプレビュー
gh skill preview nimiusrd/agent-skills commit-and-pr

開発

各スキルは skills/<skill-name>/SKILL.md を起点に構成されています。必要に応じて、スクリプト、テンプレート、リファレンス、評価ケースを同じディレクトリ内へ配置します。プラグイン全体のメタデータはルートの plugin.json にあります。

変更後は、Agent Skills 仕様と Agent Plugins マニフェストへの適合性を検証してください。

gh skill publish --dry-run
python3 -m pip install --quiet -r requirements-plugin-validate.txt
python3 -m check_jsonschema --schemafile https://agent-plugins.org/schemas/1.0.0/plugin.schema.json plugin.json

この検証は、main ブランチへの push と Pull Request でも GitHub Actions により実行されます。

公開

検証に成功したら、SemVer 形式のタグを指定して GitHub Release を作成します。

gh skill publish --tag v1.0.0

ライセンス

MIT License