What happens if a hook script is missing a shebang?

If a hook script lacks the proper shebang (like #!/usr/bin/env bun), it may fail to execute during tool use, leading to incomplete automation or errors in the development cycle.

Can this skill identify missing imports in CLAUDE.md?

Yes, it audits the memory directory and cross-references it with CLAUDE.md to ensure all standards and protocols are being correctly imported by the AI.

Why is it important to verify the .claude directory?

The .claude directory houses the logic for agents, hooks, and memory. Verifying it ensures that the AI has the correct context and that automated scripts trigger correctly during your workflow.

Does this skill check for the Research-First Protocol?

Yes, it specifically checks for the existence of research-first-protocol.md and verifies that it is set to 'alwaysApply' to ensure consistent reasoning patterns.

Claude Setup Verifier

Name: Claude Setup Verifier
Author: Dexploarer

byDexploarer

•

Developer Tools

Verifies the integrity and completeness of the .claude directory configuration to ensure optimal AI agent performance.

The verify-claude-setup skill provides a comprehensive audit of your local Claude Code environment by validating the presence and structure of critical configuration files. It checks for the correct number of AI agents, verifies that hook scripts have proper executable permissions and Bun shebangs, and ensures that the Research-First Protocol is correctly enforced across rules and memory imports. This utility is essential for developers who need to confirm that their workspace is fully optimized and that all automated workflows, slash commands, and domain-specific skills are ready for high-stakes coding tasks.

Key Features

01Checks hook script permissions and Bun runtime configurations

02Ensures Research-First Protocol is active and correctly applied

03Provides a summarized report of configuration status and missing components

04Validates agent counts and YAML frontmatter formatting

05Audits CLAUDE.md to verify all memory files are properly imported

062 GitHub stars

Use Cases

01Verifying system readiness after updating agents, hooks, or memory files

02Ensuring local environment parity after cloning or pulling updates from a repository

03Troubleshooting configuration issues when AI agents behave unexpectedly

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dexploarer/hyper-forge verify-claude-setup

For use in Claude.ai and ChatGPT

Download Skill