verify-claude-setup

Verify local .claude directory configuration for required agents, hooks, rules, memory, and commands.

7|2|Updated Nov 9, 2025
One-click install
npx skills add https://github.com/Prompt-or-Die-Labs/hyper-forge --skill verify-claude-setup-prompt-or-die-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: verify-claude-setup
Source: https://github.com/Prompt-or-Die-Labs/hyper-forge/tree/main/.claude/skills/verify-claude-setup
Command: npx skills add https://github.com/Prompt-or-Die-Labs/hyper-forge --skill verify-claude-setup-prompt-or-die-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly detect misconfiguration in your local .claude directory so your agents, hooks, rules, memory, and commands behave as intended.

Core Features & Use Cases

  • Validates Agents: Confirms the expected number of agent definitions and checks that each contains the required structure for Research-First behavior.
  • Audits Hooks: Checks hook script presence and basic executable/shebang requirements, and verifies that hook wiring is reflected in settings.
  • Verifies Rules & Memory: Ensures required rule files exist, that the research-first enforcement rule is imported, and that memory files are present.
  • Counts Commands for Readiness: Estimates whether slash commands are populated and organized before you start complex work.
  • Use Case: Use it before launching a major workflow in hyper-forge to avoid failures caused by missing or partially updated configuration.

Quick Start

Run the verify-claude-setup Skill to produce a readiness status report indicating what is correct and what is missing in your .claude configuration.

Frequently Asked Questions about verify-claude-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify my .claude configuration is ready for complex workflows?

To verify your .claude configuration, run a readiness check that validates expected file counts, required agent filenames, settings.json hook wiring, and memory presence to ensure proper operation. This produces a summary report of configuration completeness.

What is included in a .claude directory configuration audit?

A .claude directory configuration audit includes validating agent definitions for required structure, checking hook scripts for executable permissions, verifying rules and memory files exist, and counting slash commands for workflow readiness. It reports any missing or misconfigured elements.

Why are my Claude agents not behaving as intended after an update?

Claude agents may misbehave after updates due to missing or partially updated configuration files. Troubleshooting by auditing the .claude directory detects missing rules, broken hook wiring in settings.json, or absent memory files causing the unintended behavior.

How do I check if Claude hooks are properly wired in settings.json?

To check if Claude hooks are properly wired, verify hook script presence, confirm basic executable and shebang requirements are met, and validate that the hook wiring is accurately reflected in settings.json. This ensures hooks trigger correctly during agent operations.

When should I run a pre-flight check on my Claude agents and rules?

You should run a pre-flight check on your Claude agents and rules before starting complex agent workflows or launching major tasks in hyper-forge. This prevents failures caused by missing agents, unimported research-first rules, or incomplete memory configurations.

Can I use this configuration verification for troubleshooting missing Claude commands?

Yes, you can use configuration verification for troubleshooting missing Claude commands by estimating whether slash commands are populated and organized. The readiness status report highlights missing command files and incomplete directory structures before you start work.