health
Runs a budget-aware Agent Health audit for Codex, Claude Code, agent instructions, verifier surfaces, and AI maintainability when agents ignore instructions, hooks/MCP fail, validation is missing, or AI-written code is hard to maintain. Flags issues by severity. Not for debugging code or reviewing PRs.
Security Assessment
Detected risks:
About health
🥷 The Health skill provides a comprehensive audit framework for evaluating AI agent configurations and the maintainability of AI-written code within a project. It is designed to detect misalignments in agent instructions, runtime tools, verifier surfaces, and overall coding practices, especially when agents ignore instructions, hooks or MCP fail, validation is missing, or code becomes difficult to maintain. By flagging issues according to severity, this skill helps teams maintain high standards for AI behavior, configuration consistency, and project sustainability without performing standard debugging or PR reviews.
The main features of this skill include tiered project assessment (Simple, Standard, Complex), durable context preflight checks, and a structured audit workflow that covers agent configurations, instruction surfaces, runtime tools, verifiers, and maintainability layers. It can read project-specific and global instructions, analyze memory patterns, and identify potential risks like code rot, unclear contexts, missing verification, or stale paths. Its budget-aware approach starts with a summary audit and escalates to a full deep audit only under specific triggers, preserving computational resources while ensuring thorough analysis when needed.
Use cases for the Health skill include auditing AI agent configurations for compliance with project standards, detecting potential AI coding issues, and ensuring maintainable AI-written code. It is ideal for developers, AI project managers, or teams using Codex, Claude, or similar AI agents who want to maintain high code quality, prevent configuration drift, and proactively address potential risks. This skill is particularly useful in projects with multiple contributors or complex CI/CD pipelines, where configuration consistency and maintainability are critical.
FAQ
When should I use the Health skill?
Use it to audit agent configurations, AI instruction adherence, and maintainability of AI-written code. It's particularly helpful when agents ignore instructions, validation is missing, or code is difficult to maintain.
Which AI agents does it support?
It is designed for Codex and Claude agents, but its audit principles can extend to projects using similar AI agents.
Can it debug code or review pull requests?
No, it is not intended for code debugging or PR reviews. Its focus is on configuration and maintainability audits.
How does it handle large projects?
The skill categorizes projects into Simple, Standard, and Complex tiers, applying deeper audits for larger or more complex projects while remaining budget-aware.
Does it read user memory or project history?
Yes, it can read durable context and memory paths for audit purposes, but it treats these as context findings rather than code issues, and it avoids reading raw machine-specific transcripts.
All Files
9 filesInstall health
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
tw93/claude-health