Skip to content
cccskills
FreePublished on GitHub

agent-codex-convert

Convert Claude markdown subagent files to Codex CLI TOML format. Parses YAML frontmatter and body, applies model/permission/tool mappings, and outputs to agents/codex/<name>.toml.

The English summary is being prepared. Showing the original description.

See how to install

Files included (2)

  • SKILL.md3.1 KB
  • scripts/convert_agent_to_codex.sh6.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Agent Codex Convert

Goal

Convert one or more Claude agent markdown files (in agents/) to Codex CLI TOML format (in agents/codex/) using the helper script.

Default conversion helper script:

  • skills/agent-codex-convert/scripts/convert_agent_to_codex.sh

Workflow

  1. Identify which agent markdown files need conversion.
  2. Run the helper script for each file (or pass multiple).
  3. Review the generated TOML file(s) for correctness.
  4. If the source had memory: field, review the body for remaining memory-related instructions that may need manual removal.
  5. After conversion, optionally update the Makefile codex-agents-copy case statement if a new agent name was added.

Usage

Single file:

skills/agent-codex-convert/scripts/convert_agent_to_codex.sh agents/my-agent.md

Multiple files:

skills/agent-codex-convert/scripts/convert_agent_to_codex.sh agents/*.md

With options:

skills/agent-codex-convert/scripts/convert_agent_to_codex.sh \
  --reasoning-effort high \
  --output-dir agents/codex \
  --force \
  agents/investigation-diver.md

Preview without writing:

skills/agent-codex-convert/scripts/convert_agent_to_codex.sh \
  --dry-run agents/my-agent.md

Script Options

  • Positional: one or more .md file paths (required)
  • --reasoning-effort <low|medium|high>: Override default medium
  • --output-dir <dir>: Override default agents/codex
  • --force: Overwrite existing TOML without prompting
  • --dry-run: Print to stdout instead of writing files
  • -h, --help: Show usage

Conversion Mapping

Source (frontmatter)Target (TOML)Notes
model: sonnet/opus/haiku/inheritmodel = "gpt-5.3-codex"All map to same model
(default)model_reasoning_effort = "medium"Overridable via CLI
permissionMode: plansandbox_mode = "read-only"Other modes omitted
toolsConstraints section in bodyInjected before first heading
memoryComment + WARNINGCodex unsupported; review body
descriptionHeader commentTruncated to first sentence
maxTurns, backgroundComment onlyCodex unsupported

Post-Conversion Checklist

  • Verify developer_instructions reads naturally
  • If memory was present, confirm memory-related paragraphs/sections removed
  • Check Constraints section matches the original tool restrictions
  • Verify no TOML-breaking characters in the body
  • If new agent, add case entry to Makefile codex-agents-copy target

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Create or update a Markdown blog draft from recent work and export it with `YYYY-MM-DD_slug.md` naming. Output directory can be set via environment variable or CLI option; if missing, ask the user and pass it explicitly.

The English summary is being prepared. Showing the original description.

hodanov/my-pde3Updated Oct 18, 2026

変更をコミットしてドラフトPRを作成する一連のGit/ghワークフロー。ユーザーが「コミットして」「PR作って」「draft PR」等を求めたときに使用し、status/diff確認・命令形コミット・push・gh pr create --draft(--assignee hodanov)まで実行する。ユーザーの明示リクエストが無くても、実装完了後にcommitやPRが必要になった場面(dev-workflowのcommitフェーズ等)では必ずこれを使う。`git commit` や `gh pr create` を単体でBash直接実行しない。

The English summary is being prepared. Showing the original description.

hodanov/my-pde3Updated Oct 18, 2026

1 つの作業ツリーに混ざった差分を、変更理由ごとの意味単位のコミットへ分割する。ユーザーが「コミットを分割して」「意味単位で分けて」「commit-split」等を求めたとき、または機能追加・付随リファクタ・設定/ドキュメント修正が 1 コミットに混在していると気づいたときに使用する。分割案を提示して承認を得てからステージし、コミットごとに単独で成立することを確認する。メッセージ規約・push・PR の作成は commit-and-draft-pr へ委譲する。

The English summary is being prepared. Showing the original description.

hodanov/my-pde3Updated Oct 18, 2026

gitleaks + pre-commit を使ってローカルコミット時のクレデンシャル混入を機械的にブロックする。「クレデンシャル漏洩防止」「シークレット混入対策」「gitleaks」「pre-commit シークレット」「credential leak prevention」に言及した場合に使用する。

The English summary is being prepared. Showing the original description.

hodanov/my-pde3Updated Oct 18, 2026

依存パッケージ(Go modules / npm / Terraform provider / GitHub Actions / pre-commit 等)の アップグレードを、outdated 検出 → CHANGELOG・破壊的変更の確認 → 更新 → lint/test 検証 → コミットまで一連の手順で安全に適用する。「依存更新」「パッケージを上げて」「dependency update」 「go get -u」「npm update」「provider を上げる」等に言及されたときに使用する。

The English summary is being prepared. Showing the original description.

hodanov/my-pde3Updated Oct 18, 2026

ai-agents/ と dotfiles/ の編集内容を各 AI CLI(~/.claude, ~/.codex)と ~/.config へ反映するデプロイ手順。「設定を反映」「デプロイ」「~/.claude に配って」「スキル/エージェント/設定を更新したから配布」等を求められたときに使用する。

The English summary is being prepared. Showing the original description.

hodanov/my-pde3Updated Oct 18, 2026

See all skills by hodanov

Report a problem with this skill