Audits and auto-fixes a project's CLAUDE.md against Anthropic best practices. Activates during ship phase — checks conciseness, enforces @import structure for detailed docs, auto-excludes bloat, identifies hook candidates, and auto-fixes structural issues. Flags content questions for developer review.
Audits and auto-fixes a project's CLAUDE.md file for conciseness, structure, and adherence to best practices.
/plugin marketplace add brite-nites/brite-claude-plugins/plugin install workflows@brite-claude-pluginsThis skill inherits all available tools. When active, it can use any tool Claude has access to.
You are auditing a project's CLAUDE.md to ensure it follows Anthropic's official best practices and stays effective as the project evolves. This runs after compound learnings are captured, to catch any drift.
ship command after compound-learnings/workflows:setup-claude-md command includes similar audit logicRead the best-practices reference from .claude/skills/setup-claude-md/claude-code-best-practices.md. If the file is not accessible, use the audit checklist below as the authoritative guide.
CLAUDE.md should be under ~100 lines. Performance degrades with length.
docs/ with @importEvery CLAUDE.md should have (in this order):
## Build & Test Commands — How to build, test, lint, typecheck
## Code Conventions — Only non-obvious, project-specific ones
## Architecture Decisions — Key patterns and data flow
## Gotchas & Workarounds — Things that will bite you
Optional but valuable:
## Environment Setup — env vars, secrets, dependencies
## Workflow Rules — branch, commit, PR conventions
Flag missing required sections.
Detailed documentation should be extracted to docs/ and referenced via @import:
# CLAUDE.md (short, focused)
@docs/api-conventions.md
@docs/data-model.md
@docs/deployment.md
Check for:
docs/docs/architecture.mddocs/conventions.mdFlag and suggest removal of:
| Pattern | Why |
|---|---|
| Standard language conventions | Claude already knows these |
| "Write clean code" / "Follow best practices" | Self-evident |
| Detailed API documentation | Link to docs or use context7 |
| File-by-file codebase descriptions | Claude can read the code |
| Long explanations or tutorials | Extract to docs/ |
| Information that changes frequently | Will go stale quickly |
| Generic advice not specific to this project | Adds noise without value |
Verify all commands in CLAUDE.md actually work:
package.json scripts (or equivalent)Identify CLAUDE.md rules that should be deterministic hooks instead:
any type" → TypeScript strict configAdvisory rules that can be enforced deterministically should be hooks, not CLAUDE.md lines.
Look for entries that reference:
package.jsondocs/ with @import (create the file)## CLAUDE.md Audit
**Size**: [N] lines ([status: good / needs extraction / critical])
**Auto-fixed**:
- [list of changes made automatically]
**Needs your input**:
- [list of flagged items with context]
**Recommendations**:
- [suggestions for improvement]
**Hook candidates**:
- [rules that should become hooks]
_shared/validation-pattern.md for self-checking@import for anything that would make the core file unwieldyCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.
Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.
Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.