複雑なコードベースを体系的に分析し、アーキテクチャを可視化・ドキュメント化して新規開発者のオンボーディングを支援する汎用スキル。成果物は必ず `docs/` 配下に分割出力する。以下のリクエストで使用する:(1)「このコードベースを分析して」「全体像を教えて」など概要把握、(2)「アーキテクチャドキュメントを作って」「C4図を生成して」など設計ドキュメント生成、(3)「オンボーディング資料を作って」など新規開発者向け資料作成、(4)「技術的負債を洗い出して」など負債評価、(5)「機能一覧を出して」など機能インベントリ生成、(6)「この機能を操作したら何が起きるか追跡して」などユーザー操作フロー追跡、(7)「新機能の実装手順を出して」などフロント/バック横断の実装ガイド生成。特定の言語・フレームワーク・ディレクトリ構成に依存せず、どのリポジトリでも利用できる。
claude-md-manager
AGENTS.md / CLAUDE.mdの作成・編集・整理を行うスキル。CLAUDE.mdを50行以下を推奨とし、詳細ルールはrules/やスキルにモジュール化して分割管理する。
以下のリクエストで使用する: (1)「CLAUDE.mdを作って」「AGENTS.mdを整理して」などCLAUDE.mdの新規作成・編集、(2)「ルールを追加して」「rules/に分割して」などルールの追加・分離、(3)「ディレクトリ構成を更新して」など参照の更新、(4) 新しいディレクトリやルールファイルを作成した後のCLAUDE.md反映。
含まれるファイル(1)
- SKILL.md4.6 KB
SKILL.md(原文)
インストールする前に、エージェントに与えられる指示の中身を確認できます。
CLAUDE.md Manager
AGENTS.md / CLAUDE.mdをモジュール化して分割管理するためのスキル。
実体は AGENTS.md 側に置き、CLAUDE.md は AGENTS.md へのシンボリックリンクとして設定する。理由は、Claude Code 以外の Codex などのAIエージェントも同じ指示内容を共通で参照できるようにするため(AGENTS.md は複数AIツールで共通利用される標準ファイル名)。
基本原則
- AGENTS.md / CLAUDE.mdは50行以下を推奨(公式は200行以下)。詳細は
rules/やスキルにモジュール化して分割する - CLAUDE.mdにはパスと目的の参照のみ記載する
CLAUDE.mdの構成
以下のセクションを必要に応じて含める。
- タイトル・概要(1〜2行)
- ディレクトリ構成(サブディレクトリがあれば)
- ルール(参照リンク)
- その他、そのディレクトリ固有の設定
記載フォーマット
ディレクトリ構成セクション
## ディレクトリ構成
- `ディレクトリ名/` — 責務の説明。どういう時に使うか
例:
- `docs/` — 外部参考資料。ガイドライン参照や資料確認時に使う
- `rules/` — 投稿パターン・記事ルール・日々のルーティン
- `posts/` — 投稿の下書き・記録(日付フォルダで管理)
単体ファイルも同じ形式:
- `ME.md` — 代表者・会社プロフィール。自己紹介が必要な時に参照する
ルールセクション
## ルール
- `rules/ファイル名.md` — そのルールの目的
例:
- `rules/post_patterns.md` — 投稿パターン集・禁止表現・作成ルール
- `rules/writing_rules.md` — 文章の書き方ルール
ワークフロー
CLAUDE.mdの新規作成
- そのディレクトリの責務を1〜2行で記述する
- サブディレクトリがあれば「ディレクトリ構成」セクションを追加する
- rules/ があれば「ルール」セクションを追加する
- 50行以下を推奨。超える場合はモジュール化を検討する
ルール追加時
- 詳細なルールは
rules/ファイル名.mdに書く - CLAUDE.mdの「ルール」セクションに
ファイルパス— 目的 の1行を追加する - CLAUDE.mdに詳細を直接書かない
行数超過時の対処
- 詳細な説明を
rules/に切り出す - CLAUDE.mdには参照リンクのみ残す
- 重複する記述を統合する
新しいルールファイルやディレクトリを作成した時
- そのディレクトリの CLAUDE.md に
パス— 説明 の1行を追加する - ルートの AGENTS.md にも反映が必要か確認し、必要なら追加する
- 新しいトップレベルディレクトリ → AGENTS.md の「ディレクトリ構成」に追加
- サブディレクトリやルールファイル → 該当ディレクトリの CLAUDE.md に追加
参考資料
- https://code.claude.com/docs/en/memory — Claude Code公式ドキュメント(200行以下推奨、
@pathインポート、.claude/rules/分割) - https://addyosmani.com/blog/agents-md/ — 階層型アーキテクチャ、
rules/分割、最小限の記述を推奨 - https://www.humanlayer.dev/blog/writing-a-good-claude-md — 300行未満推奨、ファイル参照によるモジュール化
- https://nyosegawa.com/posts/harness-engineering-best-practices-2026/ — 50行以下推奨、モジュール分割、削減基準の解説
注意事項
- CLAUDE.mdに詳細なルールや手順を直接書かない
- 「
パス— 説明」の形式を必ず守る - ルートのAGENTS.mdには「作業前に対応ディレクトリのCLAUDE.mdとrules/を必ず読むこと」と明記する
- 新しいファイルやディレクトリを作成したら、必ず対応するCLAUDE.md / AGENTS.mdを更新する
レビュー
まだレビューはありません。使ってみた感想をお寄せください。
同じリポジトリのスキル
概要と使いどころ
AIコーディングエージェント向けの共通コーディングルール。コードの実装・修正・リファクタリング・レビュー時に使用し、前提確認、最小限の変更、検証に加え、空行・処理の区切り・目的と理由のコメントによる人間が後で理解できる可読性を厳守する。
URL・画像・テキスト要件からAIコーディングエージェント向けのDESIGN.mdを生成するスキル。「example.comをDESIGN.md化して」「このサムネをDESIGN.md化して」「クールでポップなLP用のDESIGN.mdを作って」といったリクエストで使用する。Claude Code / Cursor / Stitch に渡せば一貫したUIを生成できる、getdesign.md / awesome-design-md 準拠の9セクション構成のデザイン仕様書を出力する。CSS解析・画像目視抽出・要件生成の3パターンに対応。
Implement Feature-First architecture with Riverpod state management and Flutter Hooks in Flutter applications
日本語の概要は準備中です。原文の説明を表示しています。
添付された複数の画像を一括で圧縮・リサイズするスキル。「画像を圧縮して」「このスクショを軽くして」「リサイズして」「画像を小さくして」などのリクエストで使用する。Pillowで長辺1920pxにリサイズし、JPEG/PNGで出力先ディレクトリに保存する。
アーキテクチャ知識グラフ(memory MCP / memory.jsonl)の初期作成。「知識グラフを初期化して」「memory グラフを作って」「アーキテクチャグラフを登録して」といった依頼、またはプロジェクト初期構築完了後の仕上げとして使用する。コードベースを調査し、モジュール構成と依存関係を entities / relations として登録する。