sync-agents-symlinks

Name: sync-agents-symlinks
Availability: InStock
Author: sbluemin

Create CLAUDE.md symlinks for directories containing AGENTS.md files.

16|2|Updated Mar 17, 2026

Search Tags:#agents #linking #directory management #symlink #claudedoc

Ready to run

npx skills add https://github.com/sbluemin/fleet-harness --skill sync-agents-symlinks

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: sync-agents-symlinks
Source: https://github.com/sbluemin/fleet-harness/tree/main/.agents/skills/sync-agents-symlinks
Command: npx skills add https://github.com/sbluemin/fleet-harness --skill sync-agents-symlinks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill ensures that every directory containing an AGENTS.md file has a corresponding CLAUDE.md symlink, maintaining consistency and enabling Claude Code to access the correct doctrinal files without duplication.

Core Features & Use Cases

Symlink Creation: Automatically creates CLAUDE.md symlinks in directories that contain AGENTS.md files.
Commit Option: Allows for optional staging and committing of new symlinks to the repository.
Safety Rules: Follows strict safety rules to prevent unintended modifications and ensures symlinks point to the correct AGENTS.md files.

Quick Start

Run the sync-agents-symlinks skill to create symlinks for missing AGENTS.md directories.

Frequently Asked Questions about sync-agents-symlinks

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

FAQPage Schema

How do I create CLAUDE.md symlinks for AGENTS.md files in my repository?▼

Running the sync-agents-symlinks skill scans your repository for directories containing AGENTS.md files and automatically creates matching CLAUDE.md symlinks to maintain Claude Code consistency.

Why do I need symlinks for Claude Code doctrinal files instead of duplicating them?▼

Symlinks for Claude Code doctrinal files are needed to enable Claude Code to access AGENTS.md content without file duplication, ensuring consistency across directories while maintaining a single source of truth.

Can I automatically commit new symlinks after creating them for AGENTS.md files?▼

Yes, you can commit new symlinks using the optional commit functionality, which stages and commits newly created CLAUDE.md symlinks to maintain repository integrity after the synchronization process.

What are the safety rules for symlinking AGENTS.md files in a repository?▼

Safety rules for symlinking AGENTS.md files include strict checks to prevent unintended modifications and ensure every created CLAUDE.md symlink points correctly to its corresponding AGENTS.md file.

Does the symlink creation process work on directories without an AGENTS.md file?▼

No, the symlink creation process only targets directories that already contain an AGENTS.md file, ensuring symlinks are exclusively generated where doctrinal files exist to prevent empty or broken links.