claude-md-creatorlisted

# CLAUDE / AGENTS Context File Creator Creates repository-level context files (`CLAUDE.md`, `AGENTS.md`) that give coding agents the minimum guidance needed to work correctly in a repo. **Core principle: Only include what the agent cannot easily discover itself.** Empirical research (Gloaguen et al., 2026 — "Evaluating AGENTS.md") shows that LLM-generated context files *decrease* agent performance by 3% and increase cost by 20-23% when they contain redundant or overly broad content. Human-written, minimal context files improve performance by ~4%. The difference comes down to signal density — every unnecessary line adds cognitive load without helping the agent solve tasks. ## Trigger Conditions Invoke this skill when any of the following occur: - The `/init` command is run - The user asks to create, write, or update a `CLAUDE.md` or `AGENTS.md` - The user mentions "agent context", "initialize project", "set up Claude Code" - A repo is missing a `CLAUDE.md` and the user begins a new project setup - During `brainstorming` or `writing-plans` when the repo lacks a context file ## What to Include (highest to lowest priority) ### 1. Build, test, and lint commands (highest impact) Explicit tool and command mentions are the single most effective instruction type — agents use mentioned tools 1.6x-2.5x more often. Spell out exact commands: ``` npm run test -- --watch uv run pytest tests/ -x make lint && make typecheck ``` ### 2. Non-obvious environment setup Env vars, requir