Skip to content

refactor(agents): share skills between Claude Code and Codex - #6

Open
bubaley wants to merge 3 commits into
mainfrom
chore/shared-skills
Open

bubaley wants to merge 3 commits into
mainfrom
chore/shared-skills

Conversation

@bubaley

@bubaley bubaley commented Oct 22, 2026

Copy link
Copy Markdown
Owner

Summary

One skills folder for Claude Code and OpenAI Codex, cut down to the must-haves.

  • Layout: skills live in .agents/skills/<name>/SKILL.md (Agent Skills spec; Codex reads it natively). Claude Code only discovers .claude/skills/, so each skill there is a relative symlink .claude/skills/<name> -> ../../.agents/skills/<name> (per-skill links are documented; a symlinked skills directory is not). Frontmatter is only name + description.
  • Skills: 6 → 3.
    • new-domain — scaffolder workflow; the former domain-reviewer checklist is its self-review step.
    • design-system — tokens, App* vocabulary, Russian copy; now also adding shadcn-vue primitives (former add-shadcn-component) and the browser review (former ui-reviewer).
    • sync-template — fork upstream sync.
    • verify and release became always-on rules in AGENTS.md (make check before declaring done; commit type → release, never tag or bump by hand).
  • .claude/agents/ removed (Claude-only duplicates of the checklists now inside the skills). Claude Code hooks stay.
  • scripts/tests/test_agent_skills.py checks frontmatter, links and symlinks; CI runs the tooling tests when .agents/** or .claude/skills/** change.
  • Windows: symlinks need Developer Mode + core.symlinks=true (or WSL); otherwise only Codex sees the skills (noted in README).

Sources: Codex skills, Claude Code skills, Agent Skills spec.

Test plan

  • pytest ../scripts/tests: 75 passed, 1 skipped (hook test needs the frontend installed)
  • git ls-files -s .claude/skills — mode 120000 for all three links; SKILL.md readable through them
  • CI on this PR

🤖 Generated with Claude Code

bubaley and others added 3 commits October 22, 2026 23:19
Move the canonical skills to .agents/skills/ (Agent Skills layout read
natively by Codex) and expose each one to Claude Code through a relative
per-skill symlink in .claude/skills/.

Cut the set to new-domain, design-system and sync-template:
- new-domain ends with the backend self-review from domain-reviewer
- design-system absorbs add-shadcn-component and the ui-reviewer pass
- verify and release become always-on rules in AGENTS.md
- the Claude-only domain-reviewer and ui-reviewer subagents are removed

scripts/tests/test_agent_skills.py checks spec frontmatter, links and
the symlink for every skill. Docs, ownership map and init output follow.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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