Managing Claude <-> Codex skills and subagents in this repo

This repo is dual-tool. Before you create or edit anything under .claude/, .agents/, or .codex/, read this and the detailed rule at .claude/rules/codex-claude-sync.md.

Decision tree

Creating a new skill?

1. Does it need Claude-only features (allowed-tools, $ARGUMENTS, !`shell` preprocessing, ${CLAUDE_SKILL_DIR})?
   • Yes -> .claude/skills/<name>/SKILL.md (real directory, no symlink). Claude-only.
   • No -> .agents/skills/<name>/SKILL.md. Shared; make sync-agent-config creates the .claude/skills/<name> symlink.

Creating a new subagent?

• Always edit .claude/agents/<name>.md (markdown + YAML frontmatter). That is the source of truth.
• .codex/agents/<name>.toml is generated - never hand-edit.
• Run make sync-agent-config - the TOML appears.

Renaming or deleting?