@tacuchi/workspace-update
v1.0.0
Published
CLI that scans SKILL.md files and creates symlinks in .agents/skills/ for AI agent discovery
Maintainers
Readme
@tacuchi/workspace-update
CLI that scans SKILL.md files in your project and creates symlinks in .agents/skills/ for AI agent discovery.
Install
npm install -g @tacuchi/workspace-update
# or
npx @tacuchi/workspace-update syncUsage
# Show what would be synced (dry-run)
workspace-update status
# Create symlinks in .agents/skills/
workspace-update sync
# Also sync for a specific agent
workspace-update sync --agent claude
workspace-update sync --agent gemini
workspace-update sync --agent allHow it works
- Finds the project root via
git rev-parse --show-toplevel - Scans these paths for
SKILL.mdfiles:tools/scripts/*/SKILL.md(shallow)tools/skills/*/SKILL.md(shallow)src/**/SKILL.md(recursive)lib/**/SKILL.md(recursive)
- Creates relative symlinks in
.agents/skills/<name>→ source directory - Cleans orphan symlinks whose targets no longer contain
SKILL.md - Detects collisions with global
~/.agents/skills/
Agent support
| Agent | Action |
|-------|--------|
| claude | Symlinks in .claude/skills/ |
| gemini | Symlinks in .gemini/skills/ |
| crush | Adds paths to .crush.json |
| codex | No-op (reads .agents/skills/ directly) |
| opencode | No-op (reads .agents/skills/ directly) |
| warp | Warning: use workspace-setup |
| all | Runs all handlers |
License
MIT
