verify-claude-setup_skill

Overview

This skill verifies that the .claude directory configuration is complete and correct for the project. It runs a checklist validating agents, hooks, rules, memory imports, settings, commands, and skills to confirm everything needed for reliable agent operation is present. Use it to catch configuration gaps after edits or before critical runs.

How this skill works

The skill inspects file counts and specific file contents in .claude subfolders, ensuring expected items exist and are properly configured. It checks agent frontmatter and protocol sections, hook script counts and shebangs/permissions, rule activation flags, memory file imports in CLAUDE.md, relevant settings entries, and the approximate number of commands and skills. It returns a concise pass/fail summary and highlights specific missing or misconfigured items.

When to use it

• After updating agents, hooks, rules, or memory files
• Before starting complex or long-running agent workflows
• When the system reports unexpected agent behavior
• During onboarding or repository audits
• Before a release or deployment that relies on automated agents

Best practices

• Run the verification after every change to .claude to catch regressions early
• Keep agent YAML frontmatter and Research-First Protocol sections consistent
• Ensure hook scripts have the Bun shebang and executable permissions
• Maintain CLAUDE.md as the single source of truth for memory imports
• Version-control settings.json and validate hook lists after edits

Example use cases

• Confirm all six agents are present and include a Research-First Protocol before starting a multi-agent run
• Detect a non-executable hook script after adding new hooks to .claude/hooks/scripts
• Verify that CLAUDE.md imports all eight memory files after reorganizing docs
• Quick pre-release check to ensure hook and rule configurations are intact