writing-a-good-claude-md Skill

Based on "Writing a good CLAUDE.md" by Kyle (November 25, 2025), published on the HumanLayer Blog.

Help users write, audit, and improve CLAUDE.md (or AGENTS.md) files for AI coding agent harnesses.

Core Mental Model

CLAUDE.md is an onboarding document, not a configuration dump. It answers three questions:

• WHY — What is the purpose of this project and its components?
• WHAT — What is the tech stack, project structure, and map of the codebase?
• HOW — How does Claude actually work on this project? (build, test, verify commands)

Everything else should live elsewhere.