skills-readme-sync - SKILL.md Agent Skill

name: skills-readme-sync description: > Use this when adding, renaming, removing, or materially changing skills in this repository and the README may need to be updated. It synchronizes the README's Available Skills table with the current skill set.

このスキルは、agent-skills リポジトリ内のスキル変更に合わせて README.md のスキル一覧を同期する。スキル本体だけ直して README を更新し忘れる漏れを防ぐためのもの。

入力:

出力:

確認するもの:

find . -maxdepth 4 -name SKILL.md | sort などで実在するスキルを確認し、README の列挙漏れや古い名前を見つける。

README の説明文は SKILL.md の front matter と本文冒頭から短く要約する。

ルール:

1行で収まる短い説明にする
スキルの用途を先に書く
README では詳細手順を書きすぎない
既存の日本語トーンに合わせる
性質バッジを Description セルの先頭に付ける場合は次の書式に揃える
- 書式: **<バッジ>** — <用途の短い説明>
- 用途が定まっているバッジ:
  - **本リポジトリ専用**: 他リポジトリで使うことを想定していない、この agent-skills リポジトリ自身のメンテに紐付くスキル (例: skills-readme-sync)
- 列は増やさない (該当スキルが少数のため、列追加は表が広がるだけ)
実験的なスキルは Description の experimental バッジではなく、Experimental グループに置く

更新対象:

スキルは名前順 ASC ではなく、関連する役割でグルーピングして並べる。グループごとに小見出し (###) を付け、その下に独立した表を置く。

標準のグループ:

グループ	含めるスキルの目安
Git ローカル操作	`git-*` のうち branch / worktree / commit などローカル Git 操作を扱うもの
GitHub Issue / PR	`github-issue-` `github-pr-` など Issue / PR の作成・レビュー・返信を扱うもの
実装 / 成果物生成	Issue 着手から PR 準備までの進行管理や、Markdown/HTML 成果物生成を担うもの
要件定義 / 設計対話	設計、要件、意思決定の対話やドキュメント照合を担うもの
品質 / テスト設計	QA 観点やテストケース設計を担うもの
依存パッケージ更新	`*-dependency-update` 系 (npm / bun / uv など)
UI / フロントエンド	画面構成・スタイリングに関するもの
ブラウザ操作 / 検証	browser-use や Chrome remote debugging などブラウザ操作・接続確認に関するもの
Experimental	安定度や運用方針がまだ揺れている実験的なもの
スキル作成 / メンテナンス	スキル自体の作成・同期・連携設定に関するもの

ルール:

既存グループに馴染むスキルは新規グループを作らずそこに入れる
該当スキルが 0 件になったグループは見出しごと削除する
グループ内のソート順は、関連の強い順 または 作業フローの順 を優先し、難しい場合のみ名前順 ASC を使う
- 例: Git ローカル操作 → branch → worktree → commit のような流れ順
- 例: GitHub Issue / PR → issue → PR (create → feedback-address → review → comment-reply) のような流れ順
- 例: 依存パッケージ更新 → 言語/ランタイムのアルファベット順 (bun → npm → uv)
新しい性質のスキルが増えてどのグループにも収まらない場合のみ、新グループを追加して理由をコミットメッセージに残す

注意:

確認すること: