Skip to content

ci: verify .codex/skills stays in sync with .claude source#234

Merged
montfort merged 1 commit into
mainfrom
ci/codex-skills-sync-check
Jun 11, 2026
Merged

ci: verify .codex/skills stays in sync with .claude source#234
montfort merged 1 commit into
mainfrom
ci/codex-skills-sync-check

Conversation

@montfort

Copy link
Copy Markdown
Contributor

Summary

Adds a CI workflow (.github/workflows/ci.yml) that runs gen_codex_skills --check to guarantee dist/.codex/skills/ is always the regenerated output of dist/.claude/skills/.

Until now there was no PR CI — only the release and website-deploy workflows. The Codex skill tree is generated from the Claude source by cli/src/bin/gen_codex_skills.rs and must be regenerated by hand before each framework release. Nothing enforced that step, so a hand-edit to .claude/skills/ without re-running the generator could ship a stale .codex/skills/ tree. That is exactly the drift class behind #232 (Codex inheriting claude-code-v1.0).

Behavior

  • Triggers only when the relevant files change (on pull_request and push to main):
    • dist/.claude/skills/**
    • dist/.codex/skills/**
    • cli/src/bin/gen_codex_skills.rs
    • the workflow itself
  • Fails if the committed .codex/skills/ differs from what the generator would produce. The job log prints the fix: cd cli && cargo run --bin gen_codex_skills.
  • Follows existing repo conventions (actions/checkout@v6, dtolnay/rust-toolchain@stable, OpenSSL install for the crate's deps).

Verification

  • Workflow YAML validated locally.
  • The exact CI command passes against current main: Codex skills are in sync (12 skills).

🤖 Generated with Claude Code

Adds a CI workflow running `gen_codex_skills --check` on PRs (and pushes to
main) that touch the Claude skill sources, the generated Codex tree, or the
generator itself. Until now nothing enforced the regeneration step, so a
hand-edit to .claude/skills/ without re-running the generator could ship a
stale .codex/skills/ tree (the exact failure mode behind the #232 identity
drift). Fix locally with `cd cli && cargo run --bin gen_codex_skills`.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
@montfort montfort merged commit 2ecb980 into main Jun 11, 2026
2 checks passed
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