[Bug] Incorrectly Parsing Documentation Files as Agents During /doctor Command

Bug Description
The agents repo at https://github.com/wshobson/agents includes a README, LICENSE, and other documentation files. Claude Code attempts to parse these files as agents when the /doctor command is run. This shows errors since the files are not agents. There should be a way for agent contributors to include documentation as Markdown without Claude Code erroring because it tries to interpret the files as agents.

Environment Info

• Platform: darwin
• Terminal: iTerm.app
• Version: 2.0.0
• Feedback ID: 271b18de-8e0e-4edf-9cb6-62aff23cdeae

Errors

[{"error":"RangeError: stdout maxBuffer length exceeded\n    at unknown\n    at onData (node:child_process:153:110)\n    at emit (node:events:95:22)\n    at addChunk (internal:streams/readable:265:47)\n    at readableAddChunkPushByteMode (internal:streams/readable:243:18)\n    at handleArrayBufferViewResult (internal:streams/native-readable:79:16)\n    at <anonymous> (internal:streams/native-readable:43:68)\n    at processTicksAndRejections (native:7:39)","timestamp":"2025-09-30T00:48:53.675Z"}]

> /doctor

 Diagnostics
 └ Currently running: native (2.0.0)
 └ Path: /Users/andrewrich/.local/bin/claude
 └ Invoked: /Users/andrewrich/.local/share/claude/versions/2.0.0
 └ Config install method: native
 └ Auto-updates enabled: default (true)
 └ Search: OK (bundled)

 Agent Parse Errors
 └ Failed to parse 8 agent file(s):
   └ /Users/andrewrich/.claude/agents/README.md: Missing required "name" field in frontmatter
   └ /Users/andrewrich/.claude/agents/.github/CODE_OF_CONDUCT.md: Missing required "name" field in
 frontmatter
   └ /Users/andrewrich/.claude/agents/examples/tdd-usage.md: Missing required "name" field in
 frontmatter
   └ /Users/andrewrich/.claude/agents/.github/CONTRIBUTING.md: Missing required "name" field in
 frontmatter
   └ /Users/andrewrich/.claude/agents/README.md: Missing required "name" field in frontmatter
   └ /Users/andrewrich/.claude/agents/examples/tdd-usage.md: Missing required "name" field in
 frontmatter
   └ /Users/andrewrich/.claude/agents/.github/CONTRIBUTING.md: Missing required "name" field in
 frontmatter
   └ /Users/andrewrich/.claude/agents/.github/CODE_OF_CONDUCT.md: Missing required "name" field in
 frontmatter