/ ディレクトリ / プレイグラウンド / agent-rules-skill
● コミュニティ 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

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "agent-rules-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/netresearch/agent-rules-skill",
        "~/.claude/skills/agent-rules-skill"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "agent-rules-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/netresearch/agent-rules-skill",
        "~/.claude/skills/agent-rules-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "agent-rules-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/netresearch/agent-rules-skill",
        "~/.claude/skills/agent-rules-skill"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "agent-rules-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/netresearch/agent-rules-skill",
        "~/.claude/skills/agent-rules-skill"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "agent-rules-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/netresearch/agent-rules-skill",
        "~/.claude/skills/agent-rules-skill"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "agent-rules-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/netresearch/agent-rules-skill",
          "~/.claude/skills/agent-rules-skill"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add agent-rules-skill -- git clone https://github.com/netresearch/agent-rules-skill ~/.claude/skills/agent-rules-skill

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

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

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

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

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

前提条件
  • スキルのインストール — git clone https://github.com/netresearch/agent-rules-skill ~/.claude/skills/agent-rules-skill
フロー
  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を見る