[BUG] Claude Code has no up-to-date self-knowledge

Preflight Checklist

• [x] I have searched existing issues and this hasn't been reported yet
• [x] This is a single bug report (please file separate reports for different bugs)
• [x] I am using the latest version of Claude Code

What's Wrong?

Note: some may see this as a feature request, but one could argue that this is plainfully egregious and obvious that it can be classified as unexpected behavior (bug)

When asked to perform configuration tasks on itself (adding agents, skills, configuring settings), Claude Code operates based on incomplete or incorrect knowledge (likely outdated training data), rather than accessing current documentation. It does not use web search to find accurate information about its own configuration system, leading to failed or incorrect attempts.
Specific Example
User request: "Add a custom agent for me"
Claude's behavior:

Attempts to create YAML files for agents
Uses incorrect or outdated file formats
Does not mention or use the /agents interactive command that exists for this purpose
Makes assumptions about file structure without verification

Result: User gets incorrect guidance and must manually correct Claude's attempts.

What Should Happen?

Include basic configuration information directly in Claude Code's system prompt:

File locations for agents, skills, commands
Available CLI commands (claude mcp, /agents, /config)
Link to official documentation: https://docs.claude.com/en/docs/claude-code/

Option 3: Local Documentation
Bundle compressed documentation files with each release that Claude can reference locally before making configuration attempts.
Option 4: Enable Web Search for Self-Configuration
Allow Claude to search the web specifically when asked about Claude Code configuration, targeting official documentation.

Error Messages/Logs

Steps to Reproduce

Start Claude Code: claude
Ask: "Add a custom agent called 'test-writer'"
Observe: Claude attempts to create files with incorrect format/approach
Expected: Claude should use the /agents interactive command or provide accurate file creation instructions
Actual: Claude makes assumptions and provides incorrect guidance

Alternative reproduction:

Ask: "How do I create a skill?"
Observe: Claude provides incomplete or incorrect information about the process
Expected: Claude should know that skills are created manually in ~/.claude/skills/ or .claude/skills/ with specific YAML frontmatter requirements
Actual: Claude may suggest non-existent commands or incorrect procedures

Claude Model

Sonnet (default)

Is this a regression?

Yes, this worked in a previous version

Last Working Version

_No response_

Claude Code Version

2.0.42

Platform

Anthropic API

Operating System

Ubuntu/Debian Linux

Terminal/Shell

Terminal.app (macOS)

Additional Information

Why this matters

Claude Code is marketed as an agentic coding tool, but it cannot reliably configure itself. This creates a credibility gap where:

• Users ask Claude Code to help configure Claude Code
• Claude provides incorrect information
• Users must manually correct or search documentation themselves

This is particularly problematic because Claude Code does have built-in features (like /agents, skills system, MCP commands) that it doesn't know about or use correctly when asked.
Suggested Implementation
The simplest solution would be to include a built-in skill at installation:
~/.claude/skills/public/claude-code-config/SKILL.md (shipped with Claude Code)
yaml---
name: claude-code-config
description: Official Claude Code configuration reference. Use when user asks about configuring Claude Code, adding agents, creating skills, or setting up MCP servers.
version: 2.0.25
---

Note: I already know that some people will respond with "Why don't you just create this skill yourself?".

To which I reply: "Why is this not just bundled and built-in to Claude Code?"