Agent-Skills.md

Agent Skills: Sync Skill

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.

UncategorizedID: kyzooghost/audit-code-health-skill/sync-skill

Repository

kyzooghost/audit-code-health-skill
kyzooghostLicense: MIT

Install this agent skill to your local

pnpm dlx add-skill https://github.com/kyzooghost/skills/tree/HEAD/skills/sync-skill

Skill Files

Browse the full folder contents for sync-skill.

Download Skill

Loading file tree…

skills/sync-skill/SKILL.md

Skill Metadata

Name
sync-skill
Description
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.

Sync Skill

Overview

Sync a skill from this repository by making ~/.claude/skills/<skill> the source-facing symlink to the repo skill, then making ~/.agents/skills/<skill> and ~/.codex/skills/<skill> point at the Claude skill path.

Codex discovers local functionality from ~/.codex/skills in this setup. Do not install command files into ~/.codex/commands expecting Codex to recognize them. When the source artifact is a repo command under commands/<name>.md, use $sync-command; it creates or reuses a command-backed skill for Codex.

Use the bundled script for the filesystem changes so repeated syncs update links consistently.

Workflow

  1. Identify the repo skill name or path. Prefer a skill name when the source is skills/<name>.
  2. Inspect the source skill and confirm it contains SKILL.md.
  3. Run the installer:
python3 <this-skill-dir>/scripts/install_local_skill.py <skill-name-or-path>

Example from this repo:

python3 skills/sync-skill/scripts/install_local_skill.py handover
  1. Verify the output shows all three managed links:
    • ~/.claude/skills/<skill> -> repo skill directory
    • ~/.agents/skills/<skill> -> ~/.claude/skills/<skill>
    • ~/.codex/skills/<skill> -> ~/.claude/skills/<skill>
  2. For Codex, verify ~/.codex/skills/<skill>/SKILL.md is readable through the symlink.
  3. Tell the user to restart the relevant agent app so it reloads skill metadata.

Existing Installs

The installer replaces whatever is already at the destination:

  • Missing links are created.
  • Existing symlinks are replaced when they point somewhere else.
  • Existing real files or directories are removed and replaced with the symlink.

Options

Use --dry-run to preview changes without writing symlinks:

python3 skills/sync-skill/scripts/install_local_skill.py handover --dry-run

Use --repo-root <path> when running from outside this repository and passing a skill name.

Only override the destination directories when the user explicitly asks for non-default install roots.