symlink-manager

Create, audit, and repair cross-platform symlinks using a manifest.

5|3|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/richfrem/agent-plugins-skills --skill symlink-manager
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: symlink-manager
Source: https://github.com/richfrem/agent-plugins-skills/tree/main/plugins/link-checker/skills/symlink-manager
Command: npx skills add https://github.com/richfrem/agent-plugins-skills --skill symlink-manager

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Creates, audits, and repairs cross-platform symlinks so Windows, macOS, and Linux paths resolve identically.

Core Features & Use Cases

  • Create real symlinks across platforms, including Windows with Developer Mode considerations, to prevent broken links when moving between machines.
  • Audit and detect broken, misconfigured, or stale symlinks after OS switches or git operations.
  • Repair, restore, and document symlinks using a manifest to keep repos consistent for all contributors.

Quick Start

Run the diagnose command to verify your environment, then use the create or restore commands to fix and reestablish proper symlinks.

Frequently Asked Questions about symlink-manager

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

FAQPage Schema
How do I fix broken symlinks in a Git repo after switching between Windows, macOS, and Linux?

Cross-platform symlinks can be audited and repaired using a manifest that records link configurations. This ensures paths resolve identically across Windows, macOS, and Linux after OS switches or git operations restore consistency.

What is the best way to create symlinks that work on both Windows and macOS?

Cross-platform symlink creation uses real symlinks on supported platforms and falls back to junctions or hardlinks when necessary. A manifest documents these configurations to maintain consistency across Windows, macOS, and Linux.

Do I need Windows Developer Mode enabled to create symlinks?

Windows symlink creation involves Developer Mode considerations and permission constraints. The tool applies safety checks and falls back to junctions or hardlinks when real symlinks cannot be created due to permission limitations.

How does a symlink manifest help maintain links across different development environments?

A symlink manifest documents and records link configurations to keep Git repos consistent for all contributors. It enables restoration of symlinks after OS switches, Dev Mode changes, or permission constraints disrupt development environments.

Can I detect and audit stale symlinks after git operations or OS switches?

Auditing symlinks detects broken, misconfigured, or stale links after git operations or OS switches. A diagnose command verifies the environment and identifies which symlinks require repair or restoration to maintain path resolution.