5章. スキルを移す — $weekly-review 1行で週次の振り返り
必須 この段階を進めるなら、必ず読んでください。一言まとめ: Codexのスキルは、Claude Codeと 同じ形式(
SKILL.md)で、置く場所と呼び出す記号だけが違います。フォルダは.agents/skills、呼び出すときは$名前です。 整理ツールのスキル3つを移し、$weekly-review1行で週次の振り返りを作って、元のメモと照らし合わせます。
この章は、2026年11月1日に確認したCodexの公式ドキュメントと、このガイドの実習(Codexのターミナルで実行)をもとに書きました。スキルが何か、なぜ使うのかは、Claude Code 7章で説明しました。
同じ形式、違う場所
Codexのスキルも SKILL.md ファイルが入ったフォルダで、SKILL.md には名前(name)と説明(description)が必ずなければなりません。[1] スキルは、複数のツールが共通で使う公開標準に従っています。[2] だから、Claude Codeで作った SKILL.md を 直さずに そのまま移しました。
違うのは、置く場所と呼び出し方です。
| Claude Code | Codex | |
|---|---|---|
| このフォルダ専用 | .claude/skills/ | .agents/skills/ |
| 自分のすべてのフォルダ | ~/.claude/skills/ | ~/.agents/skills/ |
| 呼び出し方 | /名前 | $名前 |
移す前に試してみました。.claude/skills に置いたまま $weekly-review を呼ぶと、Codexはスキルの一覧からはすぐに見つけられず、ファイル検索で SKILL.md を探して見つけ出しました。今回は見つかりましたが、決まった場所に置くほうが確実です。
理解度チェック
Codex で整理ツールのフォルダ専用のスキルを置く場所と、呼び出し方として正しいものはどれでしょうか?
スキルを移す
Codexに、こう頼みました。
.claude/skills フォルダのスキル3つを、Codexが読む場所である .agents/skills にコピーして。元のフォルダはそのままにして。止められました。 4章で見た保護フォルダのためです。作業フォルダの中の .agents は、初期状態では読み取りだけができます。[5] Codexは、コピーがブロックされたと知らせ、代わりに入力するコマンドを教えてくれました。
mkdir -p .agents/skills
cp -R .claude/skills/meeting-notes .claude/skills/study-notes .claude/skills/weekly-review .agents/skills/2行の意味は次のとおりです。
mkdir -p .agents/skills:.agents/skillsフォルダを作ります。mkdirは「フォルダを作る」、-pは「途中のフォルダまで一度に作り、すでにあればそのまま進む」という意味です。cp -R コピー元1 コピー元2 コピー元3 .agents/skills/: スキルのフォルダ3つを.agents/skills/の中にコピーします。cpは「コピー」、-Rは「フォルダの中のファイルまで丸ごと」という意味です。元のフォルダはそのまま残ります。
このガイドの実習は、アプリではなく ターミナル で動かしました。許可の方式をあらかじめ決めておき、聞かないようにする方式なので、Codexは聞くことができず、そのまま止まりました(この方式は7章で扱います)。アプリでこの場面がどう見えるかは、このガイドでは直接確認できませんでした。許可を聞く画面が出たら、何をどこに書くのか を読んで判断してください。
このガイドは、Codexが教えてくれたコマンドを 自分で 実行してコピーしました。macOSのターミナルを開いて、cd ~/hello-ai-practice/organizer でフォルダに入ってから、上の2行を入力します。ターミナルが初めてなら、先にClaude Code 10章を見てください。
移したあと、.agents/skills の下に meeting-notes、study-notes、weekly-review の3つのフォルダがあればOKです。
理解度チェック
Codex にスキルを .agents/skills へコピーしてほしいと頼むと、「読み取り専用なのでブロックされました」という返事が来ました。適切な対応はどれでしょうか?
$ で呼び出す
入力欄に $ を入力すると、スキルを選んで呼び出せます。[6] 今回は、スキル名だけを送りました。
$weekly-reviewコピーを終えたあとは、ファイル検索なしで .agents/skills/weekly-review/SKILL.md を すぐに 開きました。そして、振り返りメモ3つをまとめて、週次の振り返りを作りました。
結果: スキルで作った週次の振り返り
数字と事実を、元のメモと照らし合わせてみました。
| 元のメモ | 週次の振り返り | 合っているか |
|---|---|---|
| 「いいね」12個 | 12個 | 合っている |
| 価格を6,000ウォンと書き間違えた | 6,000ウォンの誤り | 合っている |
| セット 今日4個 | 4個 | 合っている |
| セット 今週の合計11個 | 11個 | 合っている |
| インスタ 3回とも投稿した | 3回 | 合っている |
| ヴァンショーの原価1,800ウォン | なし | 抜けている |
| 電球を買って交換した | なし | 抜けている |
| 文言を書くのに2時間 | なし | 抜けている |
出典: このガイドの実習結果(2026-11-01)
間違った項目はありませんでしたが、抜けているものが3つ ありました。振り返りの様式の3つの欄(よくできたこと・残念だったこと・来週やること)にぴったり合わなくて外したのだと思われます。このように、間違いだけでなく抜けも 確認してください。抜けてはいけない内容があるなら、スキルに「ヴァンショーのように次の会議の議題になる数字は、来週やることに入れる」のように、1行足せばOKです。
呼び出さなくても、依頼がスキルの説明と合っていれば、Codexが自分でスキルを選ぶことがあります。[7] だから、説明の前のほうに いつ使うか をはっきり書いておくのがおすすめです。[8]
理解度チェック
$weekly-review で作った週間ふりかえりの数字はすべて合っていましたが、ヴァンショーの原価 1,800 ウォンが抜けていました。このガイドがすすめる次の行動はどれでしょうか?
新しいスキルの作り方とプラグイン
新しいスキルをゼロから作るときは、最初から入っている $skill-creator を呼び出して、目標・ステップ・形式を説明します。[9] 公式ドキュメントが挙げる良い最初のスキルは、週次報告や会議後のフォローアップの整理のような、ステップと形式がいつも同じ仕事 です。[10] 整理ツールの3つのスキルが、まさにその例です。
今回の実習には プラグイン は必要ありません。名前と注意点だけ知っておいてください。プラグインは、スキルと外部ツールとの接続をまとめてインストールするパッケージです。[11][12] プラグインに入っているフック(自動で動くスクリプト)は、動く前に確認して、信頼できるかを判断するように言っています。[13] 初めて見るプラグインは、Claude Code 7章で学んだように、作った人と権限を先に確認してください。
理解度チェック
初めて見るプラグインをインストールしようとしています。公式ドキュメントが強調していることはどれでしょうか?
やってみよう
- Codexに、
.claude/skillsのスキル3つを.agents/skillsにコピーしてほしいと頼む。許可を聞かれたら内容を読んで判断し、止められたら、本文の2行のコマンドをターミナル(アプリのメニュー「View → Open Terminal」でもよい)で自分で入力する。 - 新しい会話を開いて、入力欄に
$を入力し、3つのスキルが表示されるかを確認する。 $weekly-reviewを送り、結果を元のメモと照らし合わせる。間違いと抜けを別々に数える。- 抜けがあれば、スキルに1行足して、もう一度動かしてみる。
続けての課題: 6章では、毎週金曜に週次の振り返りを自動で動かす予約と、クラウド・スマートフォンを見ていきます。
まとめ
- スキルの形式(
SKILL.md)は、Claude Codeと同じ。場所は.agents/skills、呼び出しは$名前。 .agentsは保護フォルダなので、移すときに止められたり、許可が必要になったりすることがある(このガイドは、ターミナルで止められたことだけを確認)。$weekly-review1行で週次の振り返りができた。項目5つは合っていて、3つが抜けていた。- 間違いだけでなく、抜けも確認する。繰り返し起きるなら、スキルを直す。
用語まとめ
| 用語 | 読み方 | 一言でいうと |
|---|---|---|
$ メンション | ドル・メンション | Codexでスキルを名前で呼び出す方法 |
.agents/skills | エージェンツ・スキルズ | Codexがこのフォルダのスキルを探す場所 |
| skill-creator | スキル・クリエイター | 新しいスキル作りを手伝う、標準のスキル |
この章は読み終わりましたか?
学習の記録はこのブラウザにのみ保存されます。全体の進み具合は 全体目次で確認できます。
次の章: 6章. 予約・クラウド・スマートフォン
参考資料(13件)
Codex公式ドキュメント、「Build skills」。"A skill is a directory with a
SKILL.mdfile plus optional scripts and references. TheSKILL.mdfile must includenameanddescription." learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex公式ドキュメント、「Build skills」。"Skills build on the open agent skills standard." learn.chatgpt.com (確認日 2026-11-01) ↩︎
Codex公式ドキュメント、「Build skills」。"For repositories, Codex scans
.agents/skillsin every directory from your current working directory up to the repository root." / "$HOME/.agents/skills
Any skills checked into the user's personal folder." learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex公式ドキュメント、「Skills & Plugins」。"ChatGPT supports
@mentions, while Codex supports$mentions for skills." learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex公式ドキュメント、「Agent approvals & security」。"
<writable_root>/.agentsis protected as read-only when it exists as a directory." learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex公式ドキュメント、「Slash commands」。"You can also explicitly invoke skills by typing
$in the chat composer." learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex公式ドキュメント、「Build skills」。"Implicit invocation: ChatGPT or Codex can choose a skill when your task matches the skill
description." learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex公式ドキュメント、「Build skills」。"Front-load the key use case and trigger words so a host can still match the skill if descriptions are shortened." learn.chatgpt.com (確認日 2026-11-01) ↩︎
Codex公式ドキュメント、「Skills & Plugins」。"In ChatGPT, start with
@skill-creator; in Codex, use$skill-creator." learn.chatgpt.com (確認日 2026-11-01) ↩︎Codex公式ドキュメント、「Skills & Plugins」。"Good first skills include a weekly update, a campaign brief, a meeting follow-up, or any task where the steps and format should stay consistent." learn.chatgpt.com (確認日 2026-11-01) ↩︎
Codex公式ドキュメント、「Skills & Plugins」。"A plugin is an installable bundle that can include skills and Model Context Protocol (MCP) servers." learn.chatgpt.com (確認日 2026-11-01) ↩︎
ChatGPTとCodexは、ひとつのプラグイン一覧を共通で使います。Codex公式ドキュメント、「Skills & Plugins」。"ChatGPT and Codex share one universal plugin directory." learn.chatgpt.com (確認日 2026-11-01) ↩︎
Codex公式ドキュメント、「Plugins」。"Review and trust plugin hooks before they run." learn.chatgpt.com (確認日 2026-11-01) ↩︎