init

init skill の概要

init skill がやること

init は、リポジトリ用の AGENTS.md を新規作成したり、内容を改善したりします。目的はコードベースを要約することではなく、エージェントがリポジトリだけでは確実に推測できない少数の指示――たとえば、見えにくい作業フローの好み、ツール固有の癖、分かりにくい慣例、リポジトリ特有の落とし穴――を拾い上げることです。

どんな人に向いているか

新しいリポジトリで AI エージェント向けの指示を整えたいとき、肥大化した AGENTS.md を作り直したいとき、あるいは一般的なプロンプトでは何度も見落とされるミスを直したいときに使います。特に、Claude の設定を行うチームや、短くてリポジトリ固有のガイダンスに依存する任意のエージェントワークフローで有効です。

何が違うのか

init skill は「発見可能性」で絞り込む設計です。README、コード、設定、ファイル構成からエージェントが学べる内容なら、AGENTS.md に入れるべきではありません。そのため、一般的な「プロジェクトメモ」系プロンプトよりも、出力がより絞られ、行動に直結しやすくなります。

init skill の使い方

init skill をインストールする

まず skill を環境にインストールし、そのあと対象リポジトリに対して実行します。典型的なインストール例は次のとおりです:
npx skills add mcollina/skills --skill init

適切な入力を与える

init skill が最も力を発揮するのは、リポジトリのパス、明確な対象、そして本当に重要な落とし穴を見分けるための十分な文脈を与えたときです。良い入力には、実際のワークフロー、エージェントに防ぎたい典型的なミス、そしてツリー構造だけでは分からない制約が含まれます。

まず確認すべきファイル

最初に SKILL.md を読み、そのうえで README.md、AGENTS.md、metadata.json、そして存在するなら rules/、resources/、references/、scripts/ フォルダを確認します。このリポジトリは意図的にファイル構成が小さいため、SKILL.md と tile.json が主な起点になります。

ざっくりした目的を、より良いプロンプトに変える

「AGENTS.md を作って」と頼むのではなく、発見可能ではないルールだけを集めた、焦点の絞られたリポジトリ指示ファイルを作るよう依頼します。たとえば、「このリポジトリ向けに最小限の AGENTS.md を init で作成してください。コードから推測できない指示だけを残し、README や config と重複する内容は削除してください」といった頼み方です。

init skill の FAQ

init skill はどんな問題を解決するのか？

エージェント向け指示が長くなりすぎる、一般論に寄りすぎる、古くなる、という典型的な失敗を解消します。init skill は、明らかなリポジトリ情報を重複させずに、エージェントの挙動を改善する短い AGENTS.md を作るのに役立ちます。

init は Skill Authoring 向けか、それとも一般的なリポジトリ設定向けか？

主に AGENTS.md を中心としたリポジトリのセットアップと保守向けです。skills を作成している場合にも同じ考え方は役立ちますが、直接の役割はコードベース用のエージェント指示を生成・整理することです。

いつ init を使わないほうがいいか？

幅広いプロジェクト概要、オンボーディングガイド、アーキテクチャ概要が欲しいなら使わないでください。また、リポジトリに隠れた作業知識がほとんどなく、ほぼすべての案内がファイルを見れば分かる場合も、適した用途ではありません。

init skill を改善するには

具体的な失敗例を与える

init をうまく使うコツは、エージェントが何を間違え続けているのかを具体例で示すことです。たとえば、フォーマットの崩れ、危険なコマンド、ビルド手順の見落とし、誤ったファイルの参照先などです。失敗例が具体的であるほど、AGENTS.md に残すべき内容と、外すべき内容を skill が判断しやすくなります。

より良い元資料を用意する

出力品質を上げたいなら、実際の AGENTS.md、最近の README、そして制約が読み取れる CI やツール設定を渡してください。リポジトリ側で可視の慣例がどれだけ明文化されているかが多いほど、init skill はノイズを削ぎ落とし、本当に必要な情報だけを残しやすくなります。

発見可能性の価値を見直す

最初のパスが終わったら、各行を発見可能性フィルターで確認します。エージェントがリポジトリ自体から推測できるなら削除します。推測できないなら、タスクの成功率、コスト、安全性を変える場合に限って残します。

1 回エージェントを動かしたあとに反復する

最初の AGENTS.md は下書きとして扱ってください。もしエージェントが同じミスを繰り返すなら、その失敗にだけ狙いを絞った 1 行を追加し、リポジトリの内容を言い換えているだけの文は削除します。それが、init を長期的に役立つ状態に保つ最短ルートです。