# Codexの機能と実践的な使い方 🧩 「あの作業、毎回 Codex に説明し直すのが面倒…」を解決するのが Agent Skills です。再利用できる手順書を一度書けば、Codex が必要なときだけ自動で読み込みます。 🏷️ タイトル: Agent Skills(SKILL.md) 🔗 URL: 📘 概要 Agent Skills は、定型ワークフローを `SKILL.md` という1ファイルにまとめて再利用できる仕組みです。スキルは名前と説明だけが常に Codex の文脈に置かれ、実際に使うと判断したときに本文がロードされます。リポジトリ・個人・マシン共通など、置き場所でスコープを切り分けられます。 ⚙️ 機能の説明 ・スキルは `SKILL.md`（必須）に、`scripts/`（実行コード）`references/`（資料）`assets/`（テンプレ）`agents/openai.yaml`（UI設定）を加えたフォルダ構成です。 ・`SKILL.md` の先頭には frontmatter が必要で、`name` と `description` を書きます。description にはいつ発動し、どこまでが範囲かを簡潔に書くのがコツです。 ・Codex は複数の場所を優先順で走査します。リポジトリの `.agents/skills`、リポジトリ直下 `$REPO_ROOT/.agents/skills`、個人用 `$HOME/.agents/skills`、管理者用 `/etc/codex/skills`、そして OpenAI 同梱の組み込みスキルです。 ・progressive disclosure(段階的開示)により、初期文脈にはスキル名・説明・パスのみ（合計約8,000文字まで）が置かれ、本文は呼び出し時に初めて読み込まれます。これで多数のスキルを入れても文脈を圧迫しません。 🛠️ 実践的な使い方 ・新規作成は組み込みの `$skill-creator` を起動するのが簡単です。何をするスキルか、いつ発動するか、スクリプトを含めるかを対話で決められます（既定は手順のみ）。 ・明示的に呼ぶときは CLI/IDE で `/skills` を使うか、`$skill-name` のように `$` で指名します。説明が task に合致すれば暗黙的に自動選択もされます。 ・暗黙発動を禁止したいスキルは `agents/openai.yaml` で `policy.allow_implicit_invocation: false` を設定します。 ・特定のスキルを消さずに無効化したいときは `~/.codex/config.toml` の `[[skills.config]]` に対象の `path` と `enabled = false` を書きます。 💡 ユースケース リリース手順、E2E テストの流し方、社内ライブラリの正しい使い方など「人によってブレやすい定型作業」をスキル化すると、誰が Codex に頼んでも同じ品質で実行できます。チーム共通のものはリポジトリ配下に、個人の癖は `$HOME/.agents/skills` に置くと住み分けが綺麗です。 ⚠️ 注意点 ・同名スキルが複数の場所にあるとマージされず、両方がセレクタに並びます。命名は被らないようにしましょう。 ・description が曖昧だと暗黙選択が効きません。主要ユースケースを前方に置き、具体的に書くのが重要です。 ・スキルが多いと文脈節約のため description が短縮されることがあります。変更が反映されないときは Codex を再起動してください。 #OpenAICodex# #AgentSkills#

便利だけど知られていないClaude APIの機能 🧩 エージェントに毎回同じ手順を説明するの、繰り返しで非効率だと思いませんか？ ClaudeのAgent Skills（エージェントスキル）は、再利用可能な手順や能力をパッケージ化してClaudeに与える仕組みです。繰り返すワークフローを標準化し、品質の一貫性と開発効率を向上させます。 📌 タイトル：Agent Skills（エージェントスキル概要） 🔗 URL： 🧩 概要 エージェントを構築するとき、特定の手順やベストプラクティスを毎回プロンプトで指示するのは冗長です。Agent Skillsは、そうした手順・知識・ツール使用パターンをパッケージ化して「スキル」として定義し、Claudeに組み込む仕組みです。スキルはドキュメント・ツール・プロンプトの組み合わせで構成され、再利用可能なモジュールとして機能します。 🛠 使い方 スキルを定義し、エージェントの設定に追加します。スキルにはタスクの実行手順、使用するツール、品質基準などを含められます。Claudeはスキルに従って構造化されたアプローチでタスクを遂行します。スキルの追加・変更でエージェントの能力を拡張・調整できます。 🏗 本番システムへの組み込み方 ・社内業務エージェント：「経費申請の処理」「議事録の作成」などの業務手順をスキルとして定義。新しいエージェントにすぐ組み込めます。 ・開発支援Bot：「コードレビュー」「テスト作成」「ドキュメント生成」などの開発手順をスキルに。品質基準がチーム内で統一されます。 ・カスタマーサポート：「返品処理」「トラブルシュート」などの対応手順をスキル化し、回答品質の一貫性を確保。 ・マルチスキルエージェント：複数のスキルを持つ汎用エージェントを構築し、タスクに応じて適切なスキルを自動選択。 💡 ユースケース 🏢 業務手順の標準化・自動化 💻 開発ワークフローの品質統一 📞 サポート対応の一貫性確保 🤖 柔軟なマルチスキルエージェント ⚠️ 注意点 スキルの定義が曖昧だと、エージェントの動作も曖昧になります。手順を具体的に記述し、期待される出力の形式も明示するのが品質の鍵です。また、スキルが多すぎるとモデルの判断が難しくなるため、関連するスキルは整理・統合しておきましょう。 ✨ 良いエージェントは良いスキル定義から。繰り返すワークフローをスキルにして、品質と効率を同時に上げましょう。 #Claude# #LLM#