symlink-files

v2026.09.24

Explains how configuration files like .claude/CLAUDE.md, .claude/skills, .github/copilot-instructions.md, and .github/skills are symlinked to AGENTS.md and .agents/skills/. Use when managing agent instructions, checking why edits to a mirror file are lost, or setting up new agents.

GitHub
Install command
npx skhub add jimmypaolini/symlink-files
Markdown
SKILL.md

Symlinked Agent Configuration

.agents/skills/ and AGENTS.md are the single sources of truth for agent behavior in this repository. Every other agent entrypoint is a symlink to them.

When to Use This Skill

  • When wondering where to edit agent instructions.
  • When you see a file like .claude/CLAUDE.md and want to edit it (do not edit the mirror!).
  • When setting up new agent platforms that need their own instruction files.

Architecture

SymlinkTarget
.claude/CLAUDE.mdAGENTS.md
.claude/skills.agents/skills
.github/copilot-instructions.mdAGENTS.md
.github/skills.agents/skills

Never edit the mirror. Always edit the source file (AGENTS.md or the contents of .agents/skills/).

Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

MIT

Source path

.agents/skills/symlink-files

Default branch

main

Latest commit

5ac136d

Tree SHA

9af071d