跳到正文
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(原文)

安装前可以查看交给 AI 代理的指令内容。

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

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

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月19日 更新

変更をコミットしてドラフト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月19日 更新

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

中文简介正在准备中。当前显示原文说明。

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

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

中文简介正在准备中。当前显示原文说明。

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

依存パッケージ(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月19日 更新

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

中文简介正在准备中。当前显示原文说明。

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

查看 hodanov 的全部技能

报告此技能的问题