ガイド

あらゆる AI コーディングエージェントの Agent Skills(SKILL.md):Claude Code、Codex、Cline、Amp、OpenHands(2026)

各 AI コーディングエージェントはどこで SKILL.md の skill を探し、1 つの skill フォルダをすべてで使えますか?

これらのエージェントはすべて、name と description を含む YAML frontmatter を持つ SKILL.md ファイルのフォルダを読み込みます。Claude Code は .claude/skills/ と ~/.claude/skills/ を使います。Codex、Amp、OpenHands はリポジトリの .agents/skills/ と個人用の ~/.agents/skills/ を使います。Cline は .cline/skills/ と ~/.cline/skills/ を使い、.claude/skills/ も読み込みます。Amp も .claude/skills/ を読み込みます。つまり、.agents/skills/ の skill で Codex、Amp、OpenHands を、.claude/skills/ のコピーで Claude Code、Cline、Amp をカバーできます。

このページは英語版ガイドの翻訳です。コマンド、設定キー、コードは原文のままです。内容に差異がある場合は英語版が優先されます。 英語版を読む → · 他の言語: 简体中文 · 한국어 · Español · Português (Brasil)

設定の変更をいち早くチェック

これらのツールの設定、フラグ、権限ルールが変わったときに、週 1 回メール(英語)でお知らせします。内容は公式ドキュメントで確認済みです。

クイックアンサー:skill フォルダの場所

  • Claude Code:.claude/skills/NAME/SKILL.md(プロジェクト)と ~/.claude/skills/NAME/SKILL.md(個人)。プラグインも skill を同梱でき、/plugin-name:skill-name として呼び出します。
  • OpenAI Codex:Codex を起動したフォルダの .agents/skills、そこからリポジトリのルートまでの親フォルダ、~/.agents/skills、/etc/codex/skills(管理者)、同梱のシステム skill。
  • Cline:プロジェクト内の .cline/skills/(推奨)、.clinerules/skills/、または .claude/skills/、グローバルは ~/.cline/skills/。
  • Amp:プロジェクトと親フォルダの .agents/skills/ と .claude/skills/、~/.config/agents/skills/、~/.agents/skills/、~/.config/amp/skills/、~/.claude/skills/、および amp.skills.path に列挙したフォルダ。
  • OpenHands:リポジトリ内の .agents/skills/NAME/SKILL.md(レガシーの .openhands/skills と .openhands/microagents も引き続き使えます)、ユーザー用は ~/.agents/skills。

どこでも使える 1 つの SKILL.md

5 つのエージェントはすべて同じ最小構成のファイルを受け付けます。name と description を持つ YAML frontmatter の後に Markdown の指示を書きます。Cline と OpenHands は name とフォルダ名の一致を必須としているため、両者を同じにしておきます。

.agents/skills/release-notes/SKILL.md

---
name: release-notes
description: Draft release notes from recent commits. Use when the user asks for release notes or a changelog.
---

1. Read the commits since the last tag.
2. Group changes into Features, Fixes and Other.
3. Write the notes in plain Markdown.
  • Codex、Amp、OpenHands 用には .agents/skills/release-notes/ に置きます。
  • Claude Code 用には同じフォルダを .claude/skills/ に置きます。Cline と Amp もこのフォルダを読み込みます。
  • description はトリガーとして書きます。skill が何をするか、いつ使うかです。Claude Code、Codex、Cline、Amp はこのテキストをもとに skill を読み込むかどうかを判断します。

skill の実行方法

  • Claude Code:/skill-name と入力するか、リクエストが description に合致したときに Claude に読み込ませます。名前の後のテキストは $ARGUMENTS に入ります。
  • Codex:/skills を実行するか、$ と skill 名を入力します。または description から Codex に選ばせます。
  • Cline:/ と入力して skill を選ぶか、リクエストが合致したときに Cline に読み込ませます。
  • Amp:モデルは各 skill の name と description を参照し、skill が呼び出されたときに SKILL.md 全体を読み込みます。skill は amp skill add <source> でインストールします。
  • OpenHands:frontmatter に triggers リストを追加すると、メッセージにそのキーワードが含まれたときだけ skill を読み込みます。

エージェントが skill を勝手に使わないようにする

  • Claude Code:frontmatter に disable-model-invocation: true を設定します。これで自分だけが実行できるようになります。
  • Codex:agents/openai.yaml で policy.allow_implicit_invocation: false を設定します。明示的な $skill 呼び出しは引き続き使えます。skill を完全に無効にするには、~/.codex/config.toml に enabled = false の [[skills.config]] エントリを追加します。
  • Cline:チャット下の天秤アイコンのメニューにある Skills タブで skill をオフにします。
  • Amp:amp.skills.disableClaudeCodeSkills を設定すると、Claude 互換のフォルダをスキップします。
  • OpenHands:triggers リストを使い、キーワードに合致したときだけ skill を読み込むようにします。

名前が衝突したときにどのコピーが優先されるか

  • Claude Code:enterprise が personal より、personal が project より優先されます。skill は同名の .claude/commands/ ファイルより優先されます。
  • Codex:同名の skill はマージされず、両方がセレクターに表示されます。
  • Cline:グローバルの skill が同名のプロジェクト skill より優先されます。
  • Amp:検索順で最初に見つかった skill が優先されます。

注意点

  • Codex は初期の skill リストを context window の 2%(サイズ不明の場合は 8,000 文字)に制限し、skill が多い場合はまず description を短縮します。
  • Cline は SKILL.md を 5k token 未満に抑えることを推奨しています。各 skill のメタデータは起動時に約 100 token を消費します。
  • Amp は、別の場所で amp skills list を実行しても、実行中のスレッドの skill を再読み込みしません。Amp に skill の再読み込みを依頼してください。
  • Claude Code はカスタムコマンドを skill に統合したため、.claude/commands/*.md ファイルは引き続き /name コマンドを作成します。

エージェント別の完全な skill ガイド

出典

このガイドで確認した公式ドキュメント(英語)です。 英語版の確認日: 2026-10-18

その他の日本語ガイド