Skip to content

feat(agents): migrate codex-review skill to the portable ai-agents/skills layout - #209

Merged
jinyeow merged 2 commits into
mainfrom
feat/98-codex-review-portable
Aug 24, 2026
Merged

feat(agents): migrate codex-review skill to the portable ai-agents/skills layout#209
jinyeow merged 2 commits into
mainfrom
feat/98-codex-review-portable

Conversation

@jinyeow

@jinyeow jinyeow commented Aug 24, 2026

Copy link
Copy Markdown
Owner

What

Moves codex-review from claude/skills/ to the portable ai-agents/skills/ layout, per the #78 skills-portability audit. The only Claude coupling was the skill's own location: its ../_shared/review-rubric.md link already resolved to the portable shared copy at every installed destination, so relocating the directory was the whole fix.

Changes

  • ai-agents/skills/codex-review/SKILL.md: moved via git mv (history preserved); precondition note extended to cover setup.sh -m codex and flag that Pi has no codex MCP registration yet.
  • setup.ps1 / setup.sh: exclude codex-review from the Codex CLI projection (asking Codex to review itself has no target); it still projects to Claude Code and Pi.
  • ai-agents/SKILL-OWNERSHIP.md, claude/README.md, codex/README.md: updated to reflect the new location and the Codex-exclusion rationale.
  • tests/setup.Tests.ps1, tests/setup-sh.Tests.ps1: updated expected paths, added a Pi-projection assertion, kept the Codex-absence assertions.

A follow-up quick-review pass flagged that the Pi-side gap (no codex MCP server registered there yet, so the skill projects but can't run) had no tracking reference. Filed #208 and referenced it in the three docs that disclose the gap.

How to verify

Invoke-Pester tests/setup.Tests.ps1
Invoke-Pester tests/setup-sh.Tests.ps1
Invoke-ScriptAnalyzer -Path setup.ps1,tests -Settings PSScriptAnalyzerSettings.psd1 -Recurse

72/72 and 25/25 (16 skipped, platform-gated) pass locally; analyzer clean.

Closes #98

… layout

Move claude/skills/codex-review/ to ai-agents/skills/codex-review/ so it
projects to Claude Code and Pi (asking Codex for a second opinion from a
Pi session). Its ../_shared/review-rubric.md and ../_shared/dimensions.md
links already resolved to the portable ai-agents/skills/_shared/ copy at
the installed destination, so the move itself is the fix — no path
rewrite needed.

Exclude codex-review from the Codex CLI projection in setup.ps1/setup.sh:
a Codex-on-Codex self-review has no target. Update SKILL-OWNERSHIP.md,
claude/README.md, and the setup Pester/bash-dry-run tests to match.

Closes #98

Refs: AB#98
@jinyeow
jinyeow marked this pull request as ready for review August 24, 2026 23:24
@jinyeow
jinyeow merged commit 79b8cec into main Aug 24, 2026
5 checks passed
@jinyeow
jinyeow deleted the feat/98-codex-review-portable branch August 24, 2026 23:24
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.

feat(agents): migrate codex-review skill to the portable ai-agents/skills layout

1 participant