Skills CLI is canonical — npx skills

rule Fri Jul 03 2026 00:00:00 GMT+0000 (Coordinated Universal Time) rulesagentskillsnpx-skillssync

npx skills is the canonical sync mechanism

Rule

npx skills CLI (vercel-labs/skills, 68+ agents supported) is the sole way skills sync from chirag127/agent-skills to installed agents' global skills dirs. No custom junction/copy scripts.

Commands

# First-time install (all skills, all installed agents, global)
npx -y skills add https://github.com/chirag127/agent-skills -g -a '*' -s '*' -y

# Refresh (add + delete propagation)
npx -y skills update -g -y

# List installed
npx skills list -g

Auto-sync

Two triggers keep skills fresh:

Windows Scheduled Task Oriz-SyncSkills — runs npx skills update -g -y at logon + daily 09:00. Registered by scripts/register-scheduled-tasks.ps1.
CC SessionStart hook — same command, silent, ~1s. Runs on every CC session start.

Result: delete a skill in chirag127/agent-skills → push → next scheduled-task fire or CC session → gone from all agents automatically.

Global paths — where CLI installs

Agent	Target
Claude Code	`~/.claude/skills/`
OpenCode	`~/.config/opencode/skills/` (also inherits `~/.claude/skills/` per opencode.ai/docs)
Kilo Code	`~/.kilocode/skills/`

Anti-patterns

❌ npx skills remove -a <one-agent> <skill> — bug #287 deletes the canonical source, breaks every other agent's symlinks. Instead: npx skills remove <skill> (all agents) OR delete in chirag127/agent-skills repo + push + npx skills update -g -y.
❌ Adding skills at project scope (.claude/skills/, .agents/skills/) — this workspace uses global-only. Skills that need to be project-specific don't belong in agent-skills repo.
❌ Custom junction scripts (wire-agent-skills-junctions.mjs etc.) — deleted 2026-07-03. npx skills handles Windows junctions natively.
❌ Editing skills at target paths (~/.claude/skills/<name>/) — those are symlinks to canonical. Edit in the source repo instead.

Windows gotcha

npx skills default is symlink method. On Windows without Developer Mode enabled:

File symlinks may fail → CLI falls back to junctions (dirs) or --copy (files) depending on version.
If sync fails silently, run npx skills update -g -y --copy as fallback (loses live-edit but works everywhere).

To enable Dev Mode: Settings → Privacy & security → For developers → Developer Mode ON.

Fleet decision: [[decisions/agent-tooling/fleet-cc-opencode-kilo-2026-07-03]]
Skills source repo: https://github.com/chirag127/agent-skills
Skills CLI: https://github.com/vercel-labs/skills