菜单
リポジトリを coding agent 対応にするときの agent ドキュメント配線パターン(AGENTS.md を source of truth にし、CLAUDE.md は symlink にする)。新しいリポジトリのエージェント対応、coding agent ready 化、AGENTS.md / CLAUDE.md の新規作成・変換・整理、repo-local skill の設置、「エージェント向けドキュメントを整備して」という依頼のときに必ず使う。CLAUDE.md だけ・AGENTS.md だけを作ろうとしている場合もこの skill で配線を確認する。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | setup-agent-docs |
| description | リポジトリを coding agent 対応にするときの agent ドキュメント配線パターン(AGENTS.md を source of truth にし、CLAUDE.md は symlink にする)。新しいリポジトリのエージェント対応、coding agent ready 化、AGENTS.md / CLAUDE.md の新規作成・変換・整理、repo-local skill の設置、「エージェント向けドキュメントを整備して」という依頼のときに必ず使う。CLAUDE.md だけ・AGENTS.md だけを作ろうとしている場合もこの skill で配線を確認する。 |
リポジトリに agent 向けドキュメントを配線するときの標準パターン。Claude Code / Codex など複数の coding agent が同じ実体を読み、重複や乖離が生まれないようにする。
AGENTS.md が source of truth: リポジトリ直下に AGENTS.md を置き、agent 向けの規約・手順はすべてここに書く。冒頭に読了マーカーを置く:
> [!NOTE]
> After reading this AGENTS.md, say: 🤖 I read the AGENTS.md for <owner>/<repo>.
リポジトリ固有の内容だけ書く: グローバル ~/.agents/AGENTS.md に既にあるルール(uv 必須、worktree 方針、例外処理方針など)は再掲しない。再掲すると更新時に乖離する。
CLAUDE.md は AGENTS.md への相対 symlink にする: @AGENTS.md と書いた通常ファイルにはしない。
ln -s AGENTS.md CLAUDE.md
git add CLAUDE.md # mode 120000 で追跡されることを確認: git ls-files -s CLAUDE.md
symlink にする理由: Claude Code・Codex・その他ツールが同一実体を読むため、import 記法の対応差やコピー乖離が発生しない。
repo-local skill の配線: skill の source of truth は .agents/skills/<name>/SKILL.md に置き、.claude/skills は相対 symlink としてコミットする。
mkdir -p .agents/skills
ln -s ../.agents/skills .claude/skills
Codex は Claude の skill 機構を持たないが、SKILL.md はただの Markdown なので、AGENTS.md から .agents/skills/<name>/SKILL.md のパス参照で同じ手順を辿らせる。
private 境界: 社内ネットワーク、起動プロファイル、proxy 事情などの private 情報はリポジトリに一切書かない。必要な箇所には「環境固有の設定は ~/.agents/AGENTS-private.md の該当節を参照」というポインタだけを置く。グローバル AGENTS.md が AGENTS-private.md の読み込みを指示しているため、ポインタだけで agent は辿れる。
https://github.com/haralab-uec/kitada-experiments — AGENTS.md、CLAUDE.md(symlink)、.agents/skills/、.claude/skills(symlink)の実例。
実装タスクを herdr の新しいラベル付き tab 上の使い捨て実装者 Codex に agmsg 経由で委譲する。どのリポジトリでも、実装・修正・コミット・push・PR 作成を任せるとき、「codex にやらせて」「実装者に依頼」「委譲して」のとき、および main が自分でコードを書き始めそうなときに必ず使う。
Attach local files to a GitHub issue or pull request comment via Playwright CLI and return the hosted attachment URLs without submitting the comment. Use when you need GitHub-hosted image or document URLs on github.com or GitHub Enterprise Server.
AI臭い日本語をレビューし、書き手の不在、主体の弱さ、構造テンプレ、抽象語、翻訳調、表層記号をチェックして修正案まで出すスキル。ブログ記事、技術記事、note/Zenn草稿、SNS投稿、メール、README、発表原稿などの日本語を、AIっぽさの診断、採点、具体的な直し方、軽いリライト案まで含めて確認したいときに使う。
Manage Codex worklog files under `.agents/worklog/codex`, hard-gate stale learnings through `learn_index.md`, and audit learn metadata deterministically. Use when a Codex agent or user needs to bootstrap worklog context, maintain plan/todo/learn files, or validate stale learn state before trusting prior session knowledge.
Write and review shellscript documentation with shdoc annotations. Use when Codex creates, edits, or reviews `.sh` files or shell executables and should add, repair, or normalize `@file`, `@brief`, `@description`, `@arg`, `@option`, and `@example` comments to match shdoc conventions.
Use this skill when converting custom PyTorch models to Hugging Face Transformers format. Helps with: (1) Creating PretrainedConfig and PreTrainedModel classes, (2) Writing ImageProcessor/Tokenizer, (3) Compatibility testing, (4) Hub upload preparation. Use when the user wants to make their model compatible with transformers library.