Skills: Symlink Claude skills to agent skills

[JonnyBurger]

Summary

• remove obsolete .claude/commands links
• replace the partial per-skill Claude links with .claude/skills pointing to .agents/skills
• make skill synchronization validate the Claude compatibility link and update the CLI documentation

Verification

• bunx oxfmt packages/skills/scripts/sync-agent-skills.ts packages/docs/docs/cli/skills.mdx --write
• bun run build
• bun run stylecheck
• bun render-cards.ts in packages/docs

Preview

• CLI skills documentation

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
bugs	Ready	Preview, Comment	Jul 29, 2026 4:47am
remotion	Ready	Preview, Comment	Jul 29, 2026 4:47am

[pullfrog]

✅ No new issues found.

Reviewed changes — replaces per-skill symlinks in .claude/skills/ with a single directory-level symlink (../.agents/skills), removes the now-dead .claude/commands/ symlinks, and updates the skill sync script and docs to reflect the new approach.

• Remove obsolete .claude/commands/ symlinks — all 8 were dead links (.agents/commands/ no longer exists).
• Replace per-skill .claude/skills/* symlinks with a single directory symlink — a single .claude/skills → ../.agents/skills replaces 33 individual per-skill symlinks. Easier to maintain and automatically covers every skill present in .agents/skills/.
• Extend sync-agent-skills script to validate and create the Claude symlink — validates that .claude/skills is a symlink pointing to ../.agents/skills, creates it in non-check mode, and ensures the .claude/ parent directory exists.
• Update CLI skills docs — wording tightened from "per-skill symlinks" to "symlinking .claude/skills to .agents/skills".

  ^{｜ View workflow run ｜ Using DeepSeek Pro (free via Pullfrog for OSS) (Claude Opus not used — the program covers this model; add its provider key to run your pick) ｜ 𝕏}