본문으로 건너뛰기
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

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 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월 18일 업데이트

変更をコミットしてドラフト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월 18일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

hodanov/my-pde32026년 10월 18일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

hodanov/my-pde32026년 10월 18일 업데이트

依存パッケージ(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월 18일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

hodanov/my-pde32026년 10월 18일 업데이트

hodanov의 스킬 모두 보기

이 스킬의 문제 신고