Problem
The current skill recommendation in skills/agents-md/SKILL.md suggests:
If a Claude-compatible entrypoint is required, symlink CLAUDE.md to AGENTS.md.
This approach has a critical issue on Windows: creating symlinks requires UAC elevation (admin privileges) by default. Without Developer Mode enabled or running as an administrator, the mklink command and most symlink APIs will fail with an access denied error. This makes the symlink approach a poor cross-platform recommendation.
Suggested Fix
Claude Code officially supports importing other files via the @filename syntax inside CLAUDE.md. The recommended cross-platform approach is to create a CLAUDE.md that simply references AGENTS.md:
This is natively supported by Claude Code (see anthropics/claude-code#6235) and works on all platforms — including Windows — without any special permissions.
Proposed Change
Update the skill guidance to replace the symlink recommendation with:
If a Claude-compatible entrypoint is required, create a CLAUDE.md file containing @AGENTS.md to reference the shared file.
This is simpler, more portable, and aligns with Claude Code's own recommended approach for file composition.
Problem
The current skill recommendation in
skills/agents-md/SKILL.mdsuggests:This approach has a critical issue on Windows: creating symlinks requires UAC elevation (admin privileges) by default. Without Developer Mode enabled or running as an administrator, the
mklinkcommand and most symlink APIs will fail with an access denied error. This makes the symlink approach a poor cross-platform recommendation.Suggested Fix
Claude Code officially supports importing other files via the
@filenamesyntax insideCLAUDE.md. The recommended cross-platform approach is to create aCLAUDE.mdthat simply referencesAGENTS.md:@AGENTS.mdThis is natively supported by Claude Code (see anthropics/claude-code#6235) and works on all platforms — including Windows — without any special permissions.
Proposed Change
Update the skill guidance to replace the symlink recommendation with:
This is simpler, more portable, and aligns with Claude Code's own recommended approach for file composition.