verify-claude-setup
Verify .claude directory configuration is complete and correct. Use when checking if agents, hooks, rules, and memory are properly set up, or after making changes to .claude configuration.
When & Why to Use This Skill
The verify-claude-setup skill is an essential diagnostic utility designed to audit and validate the integrity of the .claude configuration directory. It ensures that agents, hooks, rules, memory modules, and custom commands are correctly structured, executable, and properly imported, preventing runtime errors and ensuring peak performance of agentic workflows.
Use Cases
- Post-Update Validation: Automatically verify the system state after modifying agent YAML frontmatter, hook scripts, or memory files to ensure no breaking changes were introduced.
- Pre-Flight Environment Check: Run a comprehensive audit before initiating complex tasks to confirm that all 11+ hooks are executable and all 8 core memory modules are correctly imported.
- Troubleshooting & Debugging: Quickly identify missing files, incorrect shebangs, or permission issues in the .claude directory when an agent fails to behave as expected.
- System Readiness Reporting: Generate a detailed status report of the agentic infrastructure, including counts for agents, rules, and skills, to confirm the environment meets project standards.
| name | verify-claude-setup |
|---|---|
| description | Verify .claude directory configuration is complete and correct. Use when checking if agents, hooks, rules, and memory are properly set up, or after making changes to .claude configuration. |
| allowed-tools | [Read, Bash, Grep, Glob] |
Verify .claude Setup
Quick verification that .claude directory is properly configured.
When to Use
- After updating agents, rules, hooks, or memory
- Before starting complex work (ensure system is ready)
- User asks "is everything set up correctly?"
- Troubleshooting configuration issues
Verification Checklist
1. Agents (should have 6)
ls .claude/agents/ | wc -l
Verify all agents have:
- Proper YAML frontmatter
- Research-First Protocol section
- Clear responsibilities
2. Hooks (should have 11 scripts + README)
ls .claude/hooks/scripts/*.ts | wc -l
Check:
- All scripts executable (
chmod +x) - All have Bun shebang (
#!/usr/bin/env bun) - settings.json has all hooks configured
- Pre-tool and Post-tool hooks exist
3. Rules (should have research-first-protocol.md)
ls .claude/rules/*.md
Verify:
- research-first-protocol.md exists
- Has
alwaysApply: true
4. Memory (should have 8 files)
ls .claude/memory/ | wc -l
Check CLAUDE.md imports all:
- research-first-enforcement.md
- coding-standards.md
- testing-standards.md
- architecture-patterns.md
- common-workflows.md
- build-commands.md
- asset-forge-guide.md
- security-protocols.md
5. Settings
grep -c "hooks" .claude/settings.json
Verify:
- SessionStart, UserPromptSubmit hooks
- PreToolUse (Bash, Write, Edit) hooks
- PostToolUse (Write, Edit, Read, Grep, Glob) hooks
- PreCompact, Stop, SubagentStop, SessionEnd hooks
6. Commands (should have ~20)
find .claude/commands -type f -name "*.md" | wc -l
Quick Verification
Run all checks:
echo "Agents: $(ls .claude/agents/ | wc -l)"
echo "Hooks: $(ls .claude/hooks/scripts/*.ts | wc -l)"
echo "Rules: $(ls .claude/rules/*.md | wc -l)"
echo "Memory: $(ls .claude/memory/ | wc -l)"
echo "Commands: $(find .claude/commands -type f -name "*.md" | wc -l)"
echo "Skills: $(ls .claude/skills/ | wc -l)"
Expected Counts
- Agents: 6
- Hook Scripts: 11
- Rules: 2 (README + research-first-protocol)
- Memory: 8
- Commands: ~20
- Skills: ~40
Report Format
Provide summary:
✅ Agents: 6/6 with Research-First Protocol
✅ Hooks: 11/11 executable, all configured
✅ Rules: research-first-protocol.md active
✅ Memory: 8/8 files, all imported in CLAUDE.md
✅ Commands: 20 organized slash commands
✅ Skills: 40 skills ready
Status: .claude configuration VERIFIED
Or if issues found:
⚠️ Agents: Missing Research-First Protocol in database-specialist.md
⚠️ Hooks: pre-tool-write.ts not executable
❌ Memory: research-first-enforcement.md not imported in CLAUDE.md
Status: Configuration INCOMPLETE - needs fixes