skills/sync-command/SKILL.md
Sync a command from this repo into local agent surfaces. Use when the user asks to make a repo command available locally, sync a local command for Claude, Agents, or Codex, update command symlinks, or expose a command to Codex as a skill.
npx skillsauth add kyzooghost/audit-code-health-skill sync-commandInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Sync a command from this repository by making ~/.claude/commands/<command>.md a symlink to the repo command file, then making ~/.agents/commands/<command>.md point at the Claude command path.
Codex does not discover slash commands from ~/.codex/commands in this setup. For Codex, the syncer ensures there is a repo-backed skill at skills/<command>/ and makes ~/.codex/skills/<command> point at that skill. If skills/<command>/SKILL.md already exists, preserve it and only refresh the command reference/link.
Use the bundled script for the filesystem changes so repeated syncs update links consistently.
commands/<name>.md.python3 <this-skill-dir>/scripts/sync_command.py <command-name>
Example from this repo:
python3 skills/sync-command/scripts/sync_command.py doc-update
~/.claude/commands/<command>.md -> repo command file~/.agents/commands/<command>.md -> ~/.claude/commands/<command>.md~/.codex/skills/<command> -> repo skill directoryskills/<command>/SKILL.md was missing, it was created as a command-backed wrapper.skills/<command>/references/command.md points at the source command file./<command> for command-aware agents and as $<command> in Codex after restarting the relevant agent app.The syncer replaces whatever is already at the destination:
For Codex skill wrappers:
skills/<command>/SKILL.md files are created.skills/<command>/SKILL.md files are preserved.skills/<command>/references/command.md is refreshed to point at the source command file.Use --dry-run to preview changes without writing symlinks:
python3 skills/sync-command/scripts/sync_command.py doc-update --dry-run
Use --repo-root <path> when running from outside this repository and passing a command name.
Use --codex-skills-dir <path> only when explicitly asked to install Codex skills outside ~/.codex/skills.
Only override the destination directories when the user explicitly asks for non-default install roots.
development
Sync a skill from this repo into the local machine's skill directories. Use when the user asks to make a repo skill available locally, sync a local skill for Claude, Agents, or Codex, update local skill symlinks, or follow the .claude/skills source link pattern with .agents/skills and .codex/skills symlinks.
testing
Use when the user asks to grill, interrogate, pressure-test, or relentlessly interview them about a plan until requirements, tradeoffs, dependencies, and implementation decisions are clear.
tools
Use when the user asks to create, update, draft, or generate a GitHub pull request, including /create-pr behavior or equivalent workflow.
development
Use when drafting a periodic performance review (annual review, mid-year, promo packet, peer feedback) from monthly win reports and supporting sources, where the goal is prose-form answers grounded in verifiable evidence.