write-root-readme について
リポジトリのルートにある README.md を整える開発者向けのエージェントスキルです。構成、バッジ、リンク、検証方法を具体的に示します。
主な機能
- 01ルートの README.md を改稿
- 02見本に沿った構成と文体
- 03バッジとプロジェクト画像の提案
- 04コマンドやリンク、ツール名の確認
活用シーン
- 01リポジトリの README を新規作成
- 02既存 README を全面的に改稿
- 03リポジトリ内のコマンドやリンクを確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ liblaf/ skills --skill write-root-readmeインストール後、Claude Code で/write-root-readmeを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlreferences/example-readme.md
詳細
ルート README を作成する
ガイドライン
- 更新するファイル:
- リポジトリのルートにある
README.md
- リポジトリのルートにある
- 参考となる構成とスタイルについては、example-readme.md を確認してください。
- バッジの使用を推奨します。参考になるバッジについては、サンプル README を参照してください。
- 該当する場合は、サンプル README にあるバッジを優先してください。
- 静的なバッジより、ライブデータを表示するバッジを優先してください。
- 見出しでの絵文字の使用を推奨します。
- ヒーローセクションの使用を推奨します。サンプル README の形式に厳密に従ってください。
- GitHub Socialify を使ってプロジェクト画像を生成してください。生成された画像には、ロゴ、タイトル、説明、スター数・フォーク数・Issue 数・プルリクエスト数のバッジがすでに含まれています。
- ドキュメントがある場合は、そのリンクを含めてください。
- ヒーローセクションでのバッジの使用を推奨します。バッジは 8 個までにしてください。
- ヒーローセクションのリンクは 4 個までにしてください。
- ヒーローセクションの後に区切り線を入れてください。
- ライセンスセクションの使用を推奨します。サンプル README の形式に厳密に従ってください。
- README で相対リンクを使用しないでください。
- 細かな変更や段階的な編集ではなく、大幅で包括的な書き直しを優先してください。
- README は簡潔にしてください。
検証
rumdl fmt .を実行してください。検出された問題は、厳格な制約ではなく参考情報として扱ってください。- 作業を終える前に、コマンド、リンク、ツール名を実際のリポジトリ内のファイルと照合して確認してください。
コメント
Markdown 対応