skills.rest
sbluemin
sblueminCOMMUNITY
Explore all skills by this author →
GitHub

sync-agents-symlinks

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

16|2|Updated Mar 17, 2026
Search Tags:#agents#linking#directory management#symlink#claudedoc
One-click install
npx skills add https://github.com/sbluemin/fleet-harness --skill sync-agents-symlinks
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
dongzhuoyaodongzhuoyao
10

meta-init

Create per-skill symlinks and configure auto-update hooks for agent configurations.

Community
Advanced
mihai-chioreanmihai-chiorean

commit-pr-etiquette

Remove automated AI-generated footers from commit messages and pull request descriptions.

Community
Basic
phucle297phucle297

plugin-structure

Explain Claude Code plugin architecture, directory layout, and manifest configuration.

Community
Advanced
diriendirien
19

agent-rules

Generate and verify AGENTS.md files with bash, jq, and git.

Community
Advanced