sync-agent-symlinks

Synchronize agent skill directories with the canonical ai-specs/skills source via symlinks.

96|104|Updated Nov 12, 2025
One-click install
npx skills add https://github.com/LIDR-academy/lidr-specboot --skill sync-agent-symlinks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-agent-symlinks
Source: https://github.com/LIDR-academy/lidr-specboot/tree/main/ai-specs/skills/sync-agent-symlinks
Command: npx skills add https://github.com/LIDR-academy/lidr-specboot --skill sync-agent-symlinks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps developers and AI system administrators to keep agent-facing skill directories synchronized with the canonical ai-specs/skills source, avoiding stale or broken symlinks that could impair AI agent performance.

Core Features & Use Cases

  • Synchronization of skill links: Creates, fixes, or removes symlinks in .claude/skills and .cursor/skills to match the canonical source.
  • Consistency maintenance: Ensures that AI agents access the latest skill versions without manual intervention.
  • Use Case: When new skills are added or renamed in ai-specs/skills, this tool automatically updates the symlink structures in the agent directories, preventing broken references during deployment.

Quick Start

Run this skill after updating ai-specs/skills to ensure your agent directories stay aligned with the canonical skill source.

Frequently Asked Questions about sync-agent-symlinks

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

FAQPage Schema
How do I synchronize AI agent skill directories with a canonical source?

To synchronize AI agent skill directories, this tool manages symlinks by creating, fixing, or removing links in directories like `.claude/skills` to match the canonical `ai-specs/skills` source, ensuring consistent exposure for AI agents.

What's the best way to fix broken symlinks in multiple AI copilot configurations?

Fixing broken symlinks across multiple AI copilot configurations is handled by verifying link integrity and safely removing broken references during the synchronization process, preventing stale or broken links from impairing agent performance.

Can I use symlink synchronization for development environments with multiple AI copilot configurations?

Yes, this symlink synchronization is specifically designed for development environments with multiple AI copilot configurations, applying registry alignment and verifying link integrity to ensure agents access the latest skill versions.

When do I need to run skill synchronization after updating the canonical source?

You need to run skill synchronization immediately after updating `ai-specs/skills` to ensure your agent directories stay aligned, as the process automatically updates symlink structures and handles conflicts when new skills are added or renamed.

Does symlink synchronization handle conflicts safely when skills are renamed in source control?

Yes, symlink synchronization handles conflicts safely by verifying link integrity and removing broken references, ensuring that renamed skills in source control do not result in broken references during deployment.