本文へ移動
cccskills
無料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.

インストール方法を見る

含まれるファイル(2)

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

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

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

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

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.

日本語の概要は準備中です。原文の説明を表示しています。

hodanov/my-pde32026年10月11日 更新

commit-and-draft-pr

無料日本語概要

変更をコミットしてドラフト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直接実行しない。

hodanov/my-pde32026年10月11日 更新

commit-split

無料日本語概要

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

hodanov/my-pde32026年10月11日 更新

credential-leak-prevention

無料日本語概要

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

hodanov/my-pde32026年10月11日 更新

dependency-update

無料日本語概要

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

hodanov/my-pde32026年10月11日 更新

deploy-ai-config

無料日本語概要

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

hodanov/my-pde32026年10月11日 更新

hodanov のスキルをすべて見る

このスキルの問題を報告する