syncing-agent-skillslisted

# Syncing Agent Skills ## Overview This skill maintains the repo's dual-harness skill strategy: - **Shared skills** live canonically in `.agents/skills/` - **Codex** discovers repo skills directly from `.agents/skills/` - **Claude Code** consumes shared skills through compatibility entries in `.claude/skills/` - **Per-skill symlinks** are preferred when the exact same skill content should serve both systems - **Real wrapper directories** are used when Claude Code or Codex needs a different name, description, metadata, or behavior The goal is to keep shared expertise in one place while allowing small Codex-specific adapters where needed. ## When to Apply - Creating a new skill that should work in both Claude Code and Codex - Migrating an existing Claude Code skill into Codex discovery paths - Renaming a skill for Codex while preserving the Claude Code version - Updating a shared skill and deciding where the real fix should live - Auditing drift between `.claude/skills/` and `.agents/skills/` ## Source Of Truth Rules ### Shared skills When the skill content can be identical in both systems: - Keep the real files in `.agents/skills/<skill-name>/` - Create a **per-skill symlink** at `.claude/skills/<skill-name>` pointing to the shared skill directory - Make shared fixes in `.agents/skills/<skill-name>/` Do **not** symlink the entire `.claude/skills/` directory. Per-skill symlinks let the repo mix: - shared skills - tool-specific wrappers - Claude-only skills that shou