sync-agent-symlinks

Synchronize agent skill symlinks between ai-specs/skills and .claude and .cursor mirrors.

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/Marcel-Carrillo/ProyectosIA --skill sync-agent-symlinks-marcel-carrillo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sync-agent-symlinks
Source: https://github.com/Marcel-Carrillo/ProyectosIA/tree/main/ai-specs/skills/sync-agent-symlinks
Command: npx skills add https://github.com/Marcel-Carrillo/ProyectosIA --skill sync-agent-symlinks-marcel-carrillo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When skills are added, removed, renamed, or moved under ai-specs/skills, the agent-facing mirrors in .claude/skills and .cursor/skills can drift out of sync, leaving broken links, orphans, or missing entries. This Skill analyzes all three locations and safely reconciles them. ## Core Features & Use Cases - Inventory and Classification: Builds inventories of canonical skills and mirror entries, classifying each entry as linked, broken, orphan, conflict, or external. - Plan-Before-Apply Sync: Computes a sync plan (to add, to fix, to remove, to skip) and shows it before making changes, asking for confirmation on deletions or conflicts. - Cross-Platform Commands: Provides Bash and PowerShell command patterns for creating and removing symbolic links, with Windows-specific guidance on symlink privileges. - Use Case: After renaming a skill folder in ai-specs/skills, run this Skill to remove the orphan symlink for the old name and create links for the new name in both .claude/skills and .cursor/skills, then verify integrity. ## Quick Start Ask the agent to sync the skill symlinks after adding a new skill to ai-specs/skills so .claude/skills and .cursor/skills expose it.

Frequently Asked Questions about sync-agent-symlinks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync .claude/skills and .cursor/skills after adding a new skill?▼

Create a symbolic link in each mirror pointing to ../../ai-specs/skills/<skill-name>. On Linux or macOS use ln -s; on Windows PowerShell use New-Item -ItemType SymbolicLink, which may require Developer Mode or administrator privileges.

How do I fix broken symlinks in .claude/skills?▼

Identify symlinks whose targets cannot be resolved, remove the broken link, and recreate it pointing to the correct canonical path under ai-specs/skills. Do not fix links pointing to unknown or external locations without confirmation.

Does creating symlinks work on Windows PowerShell?▼

Yes, but Windows symlink creation may require administrator privileges or Developer Mode. If symlinks are unavailable, do not silently copy directories; ask the user before using directory junctions or manual setup.

What happens if a real directory conflicts with a canonical skill name?▼

The entry is classified as a conflict and is never overwritten automatically. It is reported in the sync plan, and the user is asked whether to replace it, back it up, or leave it unchanged.

When should I run a skill symlink sync?▼

Run it after any change in ai-specs/skills, especially when a skill has been added, removed, renamed, moved, or reorganized, so both agent mirrors expose the same canonical skills without stale links.