spences10/claude-md-maintenance
plugins/claude-workflow/skills/claude-md-maintenance/SKILL.md
Maintain CLAUDE.md files effectively. Use when adding lessons learned, updating conventions, or restructuring project instructions.
$ install --global
skillsauthnpx skillsauth add spences10/claude-code-toolkit claude-md-maintenanceInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 25, 2026, 7:21 AM17.2s4 files scanned
SKILL.md
- name:
- claude-md-maintenance
- description:
- Maintain CLAUDE.md files effectively. Use when adding lessons learned, updating conventions, or restructuring project instructions.
CLAUDE.md Maintenance
Keep CLAUDE.md files lean, accurate, and useful.
Core Pattern
After mistakes or discoveries:
"Update CLAUDE.md so you don't make that mistake again"
This captures learnings before context resets.
When to Update
Add rules when:
- Same mistake happens twice
- Non-obvious convention discovered
- Critical project constraint identified
Remove rules when:
- Rule no longer applies (deps changed, pattern evolved)
- Duplicate or redundant with other rules
- Too specific (one-time fix, not pattern)
Structure Template
# Project Name
Brief purpose (1-2 lines).
## Key Commands
- `npm test` - run tests
- `npm run build` - production build
## Conventions
- Use X pattern for Y
- Always Z before committing
## Mistakes to Avoid
- Don't assume X (actually Y)
- Remember to check Z first
Hierarchy
Two levels, both loaded:
| File | Scope | Use For |
| --------------------- | ------------ | ------------------------------------- |
| ~/.claude/CLAUDE.md | All projects | Personal preferences, global patterns |
| .claude/CLAUDE.md | This repo | Project conventions, tech stack rules |
Project-level overrides global when conflicting.
Size Guideline
Keep under 500 lines. Claude scans on every request.
Too long? Extract to references:
## API Patterns
See [api-patterns.md](docs/api-patterns.md) for details.
References
- structure-guide.md - Section organization
- lesson-patterns.md - Writing effective rules
- hierarchy.md - Global vs project scope
Related Skills
spences10/skill-creator
development
VerifiedTrustedCommunity
Design and create Claude Skills using progressive disclosure principles. Use when building new skills, planning skill architecture, or writing skill content.
29SKILL.mdUpdated Apr 25, 2026
spences10/research
testing
VerifiedTrustedCommunity
Verify sources before presenting findings. Use when asked to research links or documentation.
29SKILL.mdUpdated Apr 25, 2026
spences10/reflect
data-ai
VerifiedTrustedCommunity
Analyze session history for learnings and persist to skills. Solves "memory zero" - correct once, never again.
29SKILL.mdUpdated Apr 25, 2026
spences10/plugin-dev
tools
VerifiedTrustedCommunity
Validate, test, and distribute Claude Code plugins and marketplaces. Use when developing plugins, debugging validation errors, or preparing for distribution.
29SKILL.mdUpdated Apr 25, 2026