health

Audit agent configuration and AI maintainability for instruction drift and control gaps.

8|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/OiAnthony/.agents --skill health-oianthony
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: health
Source: https://github.com/OiAnthony/.agents/tree/main/skills/health
Command: npx skills add https://github.com/OiAnthony/.agents --skill health-oianthony

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, jq, git, npx, and includes scripts (resource) components.

What problem does it solve?

This Skill finds when AI coding agents drift from project instructions, waste context on broken or redundant surfaces, or accumulate maintainability risks that make future work unreliable.

Core Features & Use Cases

  • Agent Configuration Audit: Checks project and runtime instruction layers for conflicts, missing trust settings, hook gaps, and MCP issues.
  • Verification and Control Review: Validates that reusable commands, hooks, and checks exist and align with the documented workflow.
  • Maintainability Health Check: Surfaces hotspots, oversized context, stale references, and documentation drift that can cause code rot or repeated AI mistakes.
  • Use Case: A team asks for a fast audit after agents start ignoring rules, and this Skill reports the exact layer that is misaligned plus the next actionable fix.

Quick Start

Ask the health skill to run a budget-aware audit of the current repository and report instruction drift, verification gaps, MCP or hook issues, and maintainability risks.

Frequently Asked Questions about health

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

FAQPage Schema
How do I audit agent configuration for instruction drift and control gaps?

To audit agent configuration, run a budget-aware diagnostic pass that checks project and runtime instruction layers for conflicts, missing trust settings, hook gaps, and MCP issues. It separates control-layer failures from maintainability risks and produces copy-pasteable remediation actions.

Why does my Claude agent ignore project instructions during code generation?

Your Claude agent may ignore project instructions due to instruction drift, control gaps, or verification coverage issues. An agent configuration audit checks hooks, MCP servers, and skills to identify the exact misaligned layer and provides actionable fixes to restore rule adherence.

What's the best way to check AI maintainability and prevent code rot in repositories?

The best way to check AI maintainability is running a health audit that surfaces hotspots, oversized context, stale references, and documentation drift. This identifies maintainability risks causing code rot or repeated AI mistakes and outputs targeted remediation steps.

Do I need python3 and jq installed to run an agent health check?

Yes, you need python3, jq, git, and npx installed as dependencies to run the agent health check. These tools execute the scripts required to audit repository agent configuration, verification coverage, and AI maintainability risks.

Can I use this audit for Codex and Pi workflows or is it limited to Claude?

You can use this audit for Claude, Codex, and Pi workflows. The health check applies to hooks, MCP servers, skills, hotspots, and durable documentation across these agent platforms to detect instruction drift and control gaps during code-rot reviews.

What are the limitations of automated maintainability audits for agent configurations?

Automated maintainability audits are limited to detecting configuration conflicts, hook gaps, MCP issues, stale references, and documentation drift. They require a summary-first, budget-aware diagnostic pass and cannot fix semantic logic errors or enforce business-specific coding standards automatically.