/ ディレクトリ / プレイグラウンド / agent-rules-skill
← 全サーバー ↗ GitHub
● コミュニティ netresearch ⚡ 即起動

agent-rules-skill

作者 netresearch · netresearch/agent-rules-skill

agents.md 規約に準拠した AGENTS.md ファイルを生成します。あらゆるコーディングエージェント（Claude Code、Cursor、Codex）にリポジトリの構成を伝えることができます。

Netresearch が開発した小規模で特化型の Claude Code スキルです。リポジトリを解析し、agents.md 規約に準拠した AGENTS.md ファイルのドラフトを作成します。agents.md は、プロジェクトの規約・ビルドコマンド・テスト方針・コントリビューションルールを一箇所にまとめて AI エージェントに伝えるための標準として普及が進んでいます。

▶ デモを見る 📦 インストール 💡 ユースケース

なぜ使うのか

主な機能

ライブデモ

実際の動作

agent-rules-skill.replay ▶ 準備完了
0/0

インストール

作者のリポジトリ · Claude Skills の公式ドキュメント

ユースケース

実用的な使い方： agent-rules-skill

AGENTS.md が未作成のリポジトリに新規生成する

👤 既存コードベースに AI コーディングエージェントを導入するチーム ⏱ ~15 min beginner

使うタイミング： チームが Claude Code や Cursor を使い始めたが、まだオリエンテーション用ドキュメントを誰も書いていない場合。

フロー
  1. リポジトリで実行する
    Use agent-rules-skill. Analyze this repo and draft an AGENTS.md following the convention.✓ コピーしました
    → ビルド・テストコマンド、リントコンフィグ、スタイルに関する注意事項、落とし穴を含むドラフト
  2. 改善する
    Add a section on where not to edit (generated files, vendor/).✓ コピーしました
    → 明示的なパスを含むセクションが追加される
  3. コミットする
    Commit as docs/AGENTS.md.✓ コピーしました
    → リポジトリルートまたは docs/ にファイルがコミットされる

結果： 今後のエージェントセッションがコンテキストを持った状態で開始できる、メンテナンス可能な AGENTS.md が完成します。

注意点
  • AGENTS.md が何でもドキュメントに肥大化する — エージェントに必要な情報に絞り、人間向けの情報は README にリンクしてください。
組み合わせ： filesystem · git

モノレポでパッケージごとの AGENTS.md を生成する

👤 モノレポのメンテナー ⏱ ~30 min intermediate

使うタイミング： パッケージごとに規約が異なり、ルート直下の AGENTS.md 1つでは不十分な場合。

フロー
  1. パッケージをスキャンする
    Use agent-rules-skill. For each package in packages/, generate a tailored AGENTS.md capturing its specifics.✓ コピーしました
    → パッケージごとに1つの AGENTS.md が生成される
  2. ルートのサマリーを作成する
    Generate a root AGENTS.md that links to per-package files and lists shared rules.✓ コピーしました
    → 各パッケージファイルへのポインターを含むルートファイル

結果： エージェントが作業対象のパッケージに応じて適切なコンテキストを取得できるようになります。

組み合わせ： filesystem

進化するリポジトリに合わせて AGENTS.md を最新に保つ

👤 AGENTS.md がすぐに陳腐化するリポジトリ ⏱ ~10 min beginner

使うタイミング： ビルドコマンドの追加や規約の変更があり、AGENTS.md の内容が実態と合わなくなった場合。

フロー
  1. 差分を確認する
    Use agent-rules-skill. Compare current AGENTS.md to what the repo actually has now. What's stale?✓ コピーしました
    → 乖離している項目のリスト
  2. 更新する
    Update only the stale parts; leave human-written sections alone.✓ コピーしました
    → 人間が書いたコメントを保持した最小限の差分

結果： AGENTS.md の信頼性が維持されます。

組み合わせ： git

組み合わせ

他のMCPと組み合わせて10倍の力を

agent-rules-skill + filesystem

生成したファイルを直接適用する

Write the draft to AGENTS.md at repo root.✓ コピーしました
agent-rules-skill + git

単独の変更としてコミットする

Commit the new AGENTS.md with a message describing what it covers.✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
scan_repo repo path あらゆるリポジトリでの最初のステップ 0
draft_agents_md scan output 新規ファイルのドラフト作成時 0
diff_check existing AGENTS.md + current repo 陳腐化チェック時 0

コストと制限

運用コスト

APIクォータ
なし
呼び出しあたりのトークン
少量 — リポジトリスキャンと短い出力
金額
無料
ヒント
大規模モノレポでは対象ディレクトリを絞って実行してください。リポジトリ全体のスキャンはトークン消費が大きくなります。

セキュリティ

権限、シークレット、影響範囲

認証情報の保管： なし
データ送信先： スキャン時にリポジトリの内容が Claude API を経由します

トラブルシューティング

よくあるエラーと対処法

生成されたコマンドが CI と一致しない

実際の CI コンフィグと照合してください。スキルは一般的なファイルから推測しますが、常に正確とは限りません。

ファイルが長すぎる

簡潔さを求めるプロンプトを使用してください。agents.md は短くまとめることが前提です。

代替案

agent-rules-skill 他との比較

代替案代わりに使う場面トレードオフ
Manually writing AGENTS.md規約が明確な小規模リポジトリ機能するが陳腐化しやすい。最新に保つには運用規律が必要
Cursor-specific .cursorrulesCursor のみを使用している場合ポータビリティがない。AGENTS.md は複数のエージェント間で共通利用可能

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る