agent-skills は何をしますか？
~/Dev/agent-skills には、私がプロジェクト全体で使用するすべてのスキル（自作のものと、ベースとしている上流のもの）が格納されています。agent-skills link を実行すると、~/.claude/skills（Claude Code）と ~/.agents/skills（Codex）にそのリポジトリへのシンボリックリンクが作成されるため、どちらかのフォルダを通じてスキルを編集すると、リポジトリ内のファイルが編集されます。
スキルの種別
- プロジェクトスキル（リポジトリ固有の
.agents/skills/、例：verify-*）：そのプロジェクト内に留めます。このファイルの残りの部分は、このリポジトリ内のスキルに関するものです。 - 自作スキル:
skills/<name>/に配置。 - 上流スキル:
vendor/<upstream>/に配置。pstack、Matt Pocock のスキル、good-css などからagent-skills updateで取得します。upstreams.tsが、それらのうちどのスキルをリンクするかを決定します。 - エージェントフォルダ内にあってリポジトリへのシンボリックリンクでないもの（
blabla-*、Claude のsynced/、Codex の.system/）は、それをインストールしたツールが所有し、そのツールが更新も行います。
realpath ~/.agents/skills/<name> で、スキルがどの種別かを確認できます。
作成
~/Dev/agent-skills/skills/<name>/SKILL.md にスキルを作成します。このパスは、skill-creator や /automate-me のデフォルトよりも優先されます。その後、agent-skills link を実行します。競合が報告された場合は、別の名前を選択してください。
編集
変更内容に応じて対応を判断します：
- 私の好み（スタイル、デフォルト設定、作業の進め方など）は自作スキルに記述します。
skills/内のスキルを拡張するか、新しいものを作成します。自作ファイルが上流の更新と競合することはありません。 - 上流スキルが私にとって適切に動作しない場合の修正は、直接
vendor/に加えます。コミットされた上流の編集はagent-skills update後も維持されますが、上流が同じ行を変更した場合に競合する可能性があるため、修正は最小限に留めてください。pstack を編集した後は、node ~/Dev/agent-skills/vendor/pstack/scripts/check-t3-native.mjs <name>が終了コード 0 を返すまで実行してください。
削除
自作スキルの場合は skills/<name>/ を削除します。上流スキルの場合は、先に私に確認してください。upstreams.ts の変更が必要になります。
完了
agent-skills link が成功し、各変更が ~/Dev/agent-skills 内で独立したコミットとしてプッシュされた時点で完了です：
- 変更したファイルのみをステージングします（
git add <paths>）。他のエージェントが作業中のファイルがある可能性があります。 - コミットメッセージには、スキルを変更した理由を記述します。
- コミット後はすぐにプッシュします。
作成時の注意
- このリポジトリは公開されているため、すべてのスキルは公開テキストとして記述します：汎用的な例を使用し、私のプロジェクト名、パス、機密情報を含めないでください。
- 他のスキルを参照する場合は、
~/.agents/skills/<name>/SKILL.mdのような完全パスを使用します。相対パス../<name>は、自作スキルと上流スキルがそれぞれ異なるフォルダに配置されるため、ここでは機能しません。 - 記述方法自体については、
~/.agents/skills/writing-for-agents/SKILL.mdに従ってください。
agent-skills を引数なしで実行すると、コマンド一覧が表示されます。