Skip to main content
ClaudeWave
Skill69 repo starsupdated 2mo ago

claude-md-check

Validate CLAUDE.md structure and completeness

Install in Claude Code
Copy
git clone --depth 1 https://github.com/claude-world/director-mode-lite /tmp/claude-md-check && cp -r /tmp/claude-md-check/skills/claude-md-check ~/.claude/skills/claude-md-check
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# CLAUDE.md Validator

Validate the project's CLAUDE.md file for completeness and best practices.

---

## Validation Checklist

### Required Sections (Must Have)
- [ ] **Project Overview** - Brief description
- [ ] **Tech Stack** - Languages, frameworks, tools
- [ ] **Commands** - dev, test, build commands

### Recommended Sections (Should Have)
- [ ] **Conventions** - Coding standards
- [ ] **Key Files** - Important files
- [ ] **Architecture** - Directory structure

### Quality Checks
- [ ] **No secrets** - No API keys in file
- [ ] **Correct commands** - Listed commands work
- [ ] **Up to date** - Matches actual dependencies

---

## Output Format

```markdown
## CLAUDE.md Validation Report

### Status: PASS / NEEDS IMPROVEMENT / MISSING

### Required Sections
| Section | Status | Notes |
|---------|--------|-------|
| Project Overview | | |
| Tech Stack | | |
| Commands | | |

### Issues Found
1. [Issue and how to fix]

### Suggestions
1. [Improvement]
```

---

## Auto-Fix

If issues found, offer to:
- Add missing sections with placeholders
- Update tech stack from package.json
- Verify and correct commands