Skip to content

feat: reshape Codex skills as a first-class product surface#909

Merged
jonnii merged 1 commit into
mainfrom
jonnii/20260504210429/reshape-Codex-skills-as-a-first-class-product
May 5, 2026
Merged

feat: reshape Codex skills as a first-class product surface#909
jonnii merged 1 commit into
mainfrom
jonnii/20260504210429/reshape-Codex-skills-as-a-first-class-product

Conversation

@jonnii
Copy link
Copy Markdown
Collaborator

@jonnii jonnii commented May 4, 2026

Codex skills (~/.codex/skills/) shipped today as Claude templates with
$ARGUMENTS replaced — keeping model:, AskUserQuestion, !... macros, and
~/.claude/skills paths Codex either ignores or treats as noise.

Reshape Codex output without touching Claude (which stays byte-identical):

  • Add codexDescriptions corpus with trigger-phrase routing descriptions
    for all 17 commands plus the stackit router.
  • Extend renderCodexSkillContent to strip model:, filter Claude-only entries
    from allowed-tools, rewrite ~/.claude paths, strip !... macros, rewrite
    cross-skill 'Skill tool' prose to direct instructions, and rewrite
    AskUserQuestion prose to plain 'ask the user'.
  • Apply the same frontmatter + body transforms to file-group installs so
    router SKILL.md, references/, and subagent files all get the treatment.
  • Add a templates/codex_overrides/ tree with per-file precedence: slim
    router SKILL.md, three references (workflows, commit-style,
    stack-plan-recovery), and execution-checklist bodies for stack-create
    and stack-plan.
  • Wire format through installFileGroup and installCommandSkills so the
    override loader is keyed off agentSkillFormatCodex.
  • Add tests: override precedence, full-tree banned-substring lint, Claude
    byte-identical guard, and per-transform unit cases.

@jonnii jonnii force-pushed the jonnii/20260504210429/reshape-Codex-skills-as-a-first-class-product branch 4 times, most recently from 54d3a4d to 164d8d5 Compare May 5, 2026 01:01
Codex skills (~/.codex/skills/) shipped today as Claude templates with
$ARGUMENTS replaced — keeping model:, AskUserQuestion, !`...` macros, and
~/.claude/skills paths Codex either ignores or treats as noise.

Reshape Codex output without touching Claude (which stays byte-identical):

- Add codexDescriptions corpus with trigger-phrase routing descriptions
  for all 17 commands plus the stackit router.
- Extend renderCodexSkillContent to strip model:, filter Claude-only entries
  from allowed-tools, rewrite ~/.claude paths, strip !`...` macros, rewrite
  cross-skill 'Skill tool' prose to direct instructions, and rewrite
  AskUserQuestion prose to plain 'ask the user'.
- Apply the same frontmatter + body transforms to file-group installs so
  router SKILL.md, references/, and subagent files all get the treatment.
- Add a templates/codex_overrides/ tree with per-file precedence: slim
  router SKILL.md, three references (workflows, commit-style,
  stack-plan-recovery), and execution-checklist bodies for stack-create
  and stack-plan.
- Wire format through installFileGroup and installCommandSkills so the
  override loader is keyed off agentSkillFormatCodex.
- Add tests: override precedence, full-tree banned-substring lint, Claude
  byte-identical guard, and per-transform unit cases.
@jonnii jonnii force-pushed the jonnii/20260504210429/reshape-Codex-skills-as-a-first-class-product branch from 164d8d5 to 019a362 Compare May 5, 2026 01:18
@jonnii jonnii merged commit 7a351e3 into main May 5, 2026
8 checks passed
@jonnii jonnii deleted the jonnii/20260504210429/reshape-Codex-skills-as-a-first-class-product branch May 5, 2026 01:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant