From 1cf59f84a1af058fd10601bebfb31b1aa1ecde8a Mon Sep 17 00:00:00 2001 From: Matt Van Horn <455140+mvanhorn@users.noreply.github.com> Date: Sat, 9 May 2026 09:36:28 -0700 Subject: [PATCH 1/2] docs(codex): rename Step 0 to avoid collision with platform-detect prelude The codex skill template had its own '## Step 0: Check codex binary' heading (line 42), which after gen-skill-docs collided with the platform-detection prelude '## Step 0: Detect platform and base branch' (injected by scripts/resolvers/utility.ts). The generated codex/SKILL.md ended up with two H2 headings labeled Step 0, which is ambiguous to an agent reading the skill in order. Renamed the local heading to Step 0.4, slotting it between the prelude (Step 0) and the existing Step 0.5 / Step 0.6 sections. No renumbering of downstream steps needed. Closes #1388 Co-Authored-By: Claude Opus 4.7 (1M context) --- codex/SKILL.md.tmpl | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/codex/SKILL.md.tmpl b/codex/SKILL.md.tmpl index 90dd1119c..ed118a119 100644 --- a/codex/SKILL.md.tmpl +++ b/codex/SKILL.md.tmpl @@ -39,7 +39,7 @@ assumptions, catches things you might miss. Present its output faithfully, not s --- -## Step 0: Check codex binary +## Step 0.4: Check codex binary ```bash CODEX_BIN=$(which codex 2>/dev/null || echo "") From 796410413af5df9a555e9fbe36f2c73e664db993 Mon Sep 17 00:00:00 2001 From: Matt Van Horn <455140+mvanhorn@users.noreply.github.com> Date: Sat, 9 May 2026 09:36:28 -0700 Subject: [PATCH 2/2] docs(codex): regenerate SKILL.md after Step 0 rename Co-Authored-By: Claude Opus 4.7 (1M context) --- codex/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/codex/SKILL.md b/codex/SKILL.md index b71d1ed40..0cf48e0fc 100644 --- a/codex/SKILL.md +++ b/codex/SKILL.md @@ -792,7 +792,7 @@ assumptions, catches things you might miss. Present its output faithfully, not s --- -## Step 0: Check codex binary +## Step 0.4: Check codex binary ```bash CODEX_BIN=$(which codex 2>/dev/null || echo "")