2026.03.16

CodexでSKILL.mdを試してみた

まずは「Hello, world!」で動作確認

Codex には SKILL.md という仕組みがあり、よく使う手順や振る舞いを“スキル”として定義できます。

そこで今回は、Codex のデスクトップアプリで、まずはハローワールド的な最小構成の skill を作って、Codex が認識して使えるかを確認してみました。

やったこと

まず、Mac のホームディレクトリ配下に、グローバル skill 用のフォルダを新規作成しました。

mkdir -p ~/.agents/skills/hello-skill

その中に SKILL.md を作成し、以下の内容を書きました。

---
name: hello-skill
description: ユーザーが $hello-skill と明示的に呼び出したときだけ使う。必ず「Hello, world!」と最初に返す。
---

# Instructions
- このスキルが明示的に呼ばれたら、返答の最初の行を必ず `Hello, world!` にする。
- その後に、`スキルは正常に読み込まれました。` と書く。
- 明示的に呼ばれていない場合は、このスキルを使わない。

Codexで試してみた

Codex アプリで、次のように入力してみました。

$hello-skill を使ってください

以下のように表示されました。成功!

Hello, world!
スキルは正常に読み込まれました。

まとめ

ひとまず動作確認できました。これから活用していきたいと思います。