claude-md
CLAUDE.md Writer
Helps create effective CLAUDE.md files that onboard Claude to a codebase without wasting context.
Core principle
More instructions hurt performance. Every line in CLAUDE.md is injected into every session, consuming the model's limited instruction budget. Write the minimum needed to cover what Claude cannot infer from the code itself.
A good CLAUDE.md answers exactly three questions:
| Dimension | Question |
|---|---|
| WHAT | What is this codebase? Tech stack, repo structure, key directories |
| WHY | What is its purpose? What do the major components do? |
| HOW | How does work get done? Build, test, lint commands; tooling quirks |
Workflow
Step 1: Audit the project
More from rcgsheffield/skills
systemd-units
Create and harden systemd service unit files following modern best practices. Use when writing new systemd units for web applications, background workers, or daemons, or when hardening existing services with security sandboxing and isolation features. Covers service types, dependencies, restart policies, security options, and filesystem restrictions.
10django-development
Comprehensive guide for building Django web applications following Django 5.2 standards and industry best practices. Use when developing Django projects, implementing models/views/templates, configuring settings, handling forms, ensuring security, or deploying Django applications.
10accessible-web-dev
Build WCAG 2.1 AA compliant web applications for University of Sheffield. Covers semantic HTML, ARIA patterns, form accessibility, keyboard navigation, color contrast, alt text, captions, and automated testing. Use when creating websites, web apps, forms, interactive components, or auditing accessibility for WCAG compliance, screen readers, keyboard access, or inclusive design.
7