docs(skills): make AGENTS.md the single source of truth - #46
Merged
Merged
Conversation
Rewrites CLAUDE.md references across the community skill packages so AGENTS.md is the only agent-instructions file the skills point at. - Renamed plain project-instruction references (228 occurrences, 84 files) - Deduped lists that named both files (27 edits) - Removed companion-file / symlink guidance that told authors to create a CLAUDE.md next to AGENTS.md -- obsolete under a single source of truth Deliberately left unchanged, because renaming them would make the skills factually wrong: - Claude Code's own artifacts: `~/.claude/CLAUDE.md`, `CLAUDE.local.md`, `.claude/CLAUDE.md`, `--claude-md` - Skills whose subject is Claude Code itself (cursor-claude-md, ag-claude-code-guide, agc-claude*, prompt-CLAUDE, ...) - File paths and URLs into third-party repos ruff clean; 382 tests pass; registry regenerated. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Rewrites CLAUDE.md references across the community skill packages so AGENTS.md is the only agent-instructions file the skills point at.
What changed — 104 files
AGENTS.mdCLAUDE.mditemThe third group actively told authors to create a
CLAUDE.mdnext toAGENTS.md(ln -s AGENTS.md CLAUDE.md, "also generate a CLAUDE.md in the same folder", "exist only as pointers to it"). Those contradict the policy, so they were rewritten rather than renamed.Deliberately left unchanged
A blind rename produces false documentation, so these were excluded:
~/.claude/CLAUDE.md,CLAUDE.local.md,.claude/CLAUDE.md,--claude-md. These name real files; renaming them invents paths that do not exist.cursor-claude-md,ag-claude-code-guide,agc-claude*,prompt-CLAUDE,agent-config-migration,cursor-cross-tool-config. Renaming guts their content.claude-code-flow/CLAUDE.md,github.com/kubestellar/console/blob/main/CLAUDE.md. Renaming breaks real links.Verification
ruff checkclean · 382 tests pass · registry regenerated (unchanged).🤖 Generated with Claude Code