Agent Setup Health Audit
tw93/Waza
Audits a project's agent configuration, instruction drift, hooks, MCP and AI maintainability, then reports prioritized findings with evidence and next actions.
Runs a budget-aware agent-assisted engineering health audit for instruction/config drift, hooks/MCP, verifier surfaces, and AI maintainability.
Install Health
The automated check flagged lines worth reading first. See the safety section below.
$ npx skills add ninehills/skills --skill health -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install ninehills/skills health --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/ninehills/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/health .claude/skills/health && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "health" agent skill from https://github.com/ninehills/skills/tree/main/health into .claude/skills/health/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "health", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/ninehills/skills/tree/main/healthType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add ninehills/skills --skill health -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install ninehills/skills health --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ninehills/skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/health .agents/skills/health && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "health" agent skill from https://github.com/ninehills/skills/tree/main/health into .agents/skills/health/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "health", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ninehills/skills --skill health -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install ninehills/skills health --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ninehills/skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/health .cursor/skills/health && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "health" agent skill from https://github.com/ninehills/skills/tree/main/health into .cursor/skills/health/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "health", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/ninehills/skills.git --path health--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add ninehills/skills --skill health -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install ninehills/skills health --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ninehills/skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/health .gemini/skills/health && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "health" agent skill from https://github.com/ninehills/skills/tree/main/health into .gemini/skills/health/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "health", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install ninehills/skills healthInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add ninehills/skills --skill health -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/ninehills/skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/health .github/skills/health && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "health" agent skill from https://github.com/ninehills/skills/tree/main/health into .github/skills/health/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "health", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ninehills/skills --skill health -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install ninehills/skills health --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ninehills/skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/health .opencode/skills/health && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "health" agent skill from https://github.com/ninehills/skills/tree/main/health into .opencode/skills/health/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "health", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
health- GitHub stars
- 280
- Token cost
- ~5.4k tokens
- SKILL.md length
- 2,735 words
- Files
- 13 (incl. scripts)
- Skills in repo
- 38
- Repo updated
- First seen
- Licence
- None found
At a glance
Runs a budget-aware agent-assisted engineering health audit for instruction/config drift, hooks/MCP, verifier surfaces, and AI maintainability.
- Works in 4 steps: Assess project tier → Collect data → Analyze → …
- Users ask in any language to audit Claude
- SKILL.md covers Outcome Contract, Durable Context Preflight, Step 0: Assess project tier and Step 1: Collect data, plus 6 more sections
- Runs Shell and Python scripts from its folder; calls bash, git and npx
What it does
Health is an agent skill from ninehills/skills. Runs a budget-aware agent-assisted engineering health audit for instruction/config drift, hooks/MCP, verifier surfaces, and AI maintainability. Use when users ask in any language to audit Claude, Codex, Pi, agent instructions, MCP or hooks, verifier coverage, or AI-maintainability drift. Not for debugging application code or reviewing PRs.
Its SKILL.md is about 5.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 14 other files, including scripts (for example `agents/inspector-context.md`, `agents/inspector-control.md` and `agents/inspector-maintainability.md`).
It sits in Agent Workflows, covering Agent instruction files. It works with Model Context Protocol.
When your agent uses it
- Users ask in any language to audit Claude
- Agent instructions
- Verifier coverage
- AI-maintainability drift
Example prompts
- “/health”
Requirements
- Python 3
- Node.js
- A Bash shell
Workflow steps
4 steps, taken from the step headings in SKILL.md.
- Assess project tier
- Collect data
- Analyze
- Report
What it can do on your machine
Read from SKILL.md and the folder at commit f3e82a7. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 9 files in scripts/ (Shell and Python), which the agent can run.
Shell commands in SKILL.md call:
bashgitnpxcurlwgetshgonpm
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git, npx, curl, wget and npm, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Health loads about 5.4k tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 2,735 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check: warnings
The automated check found patterns that need a careful read before installing.
- WarningPipes a downloaded script straight into a shellSKILL.md:97
`secrets*`), pipe-to-shell installers (`curl ... | bash`, `wget ... | sh`), and outbound shells (`ssh`, `scp`, `nc`). Re - NoteMentions a .env fileSKILL.md:97
providers, GPG, gh CLI), secret files (`.env`, `credentials*`, `secrets*`), pipe-to-shell installers (`curl ... | bash`
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
Without a licence we can't republish the file, so here is its outline and opening line. It has 2,735 words (~5,445 tokens).
“Prefix your first line with 🥷 inline, not as its own paragraph.”
- name
- health
- when_to_use
- 检查claude, 检查codex, 检查pi, Codex 配置, Pi 配置, AGENTS.md, config.toml, agent instructions, 健康度, 配置检查, 配置对不对, AI coding 腐化, 代码变烂, 维护性, 上下文混乱, 验证缺失, 验证命令失真, Claude…
- dispatch_intent
- Codex/Claude/Pi ignoring instructions, agent config audit, hooks/MCP broken, health token usage, AI coding code rot, hotspot ownership, unclear context…
Files
SKILL.md and 12 other files (scripts) in health of ninehills/skills.
- SKILL.md
- agents/inspector-context.md
- agents/inspector-control.md
- agents/inspector-maintainability.md
- scripts/check-agent-context.sh
- scripts/check-doc-refs.sh
- scripts/check-maintainability.sh
- scripts/check-verifier-output.sh
- scripts/check_agent_context.py
- scripts/check_doc_refs.py
- scripts/check_maintainability.py
- scripts/check_verifier_output.py
- scripts/collect-data.sh
Open the folder on GitHubat commit f3e82a7
Compare with similar skills
Health next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Health this skillninehills/skills | 280 | — | ~5.4k | Automated safety check: Warn | None | |
| Agent Setup Health Audittw93/Waza | 7.2k | — | ~5.2k | Automated safety check: Notes | MIT | |
| Agnixagent-sh/agnix | 445 | — | ~874 | Automated safety check: Pass | Apache-2.0 | |
| Agnixagent-sh/agnix | 445 | — | ~563 | Automated safety check: Pass | Apache-2.0 | |
| Bringupjenissimo/bottleship | 152 | — | ~2.9k | Automated safety check: Pass | Apache-2.0 | |
| Drydock Repo Harness SetupYeachan-Heo/oh-my-claudecode | 40k | — | ~5.2k | Automated safety check: Pass | MIT |
Similar skills
Agnix
agent-sh/agnix
A skill your agent uses when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'.
Agnix
agent-sh/agnix
A skill your agent uses when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'.
Bringup
jenissimo/bottleship
Drive and observe the BottleShip emulator to bring up a game, using the AI-agent harness (window.BS.harness + bun tools/harness.ts).
Drydock Repo Harness Setup
Yeachan-Heo/oh-my-claudecode
Sets up a shared repo environment for people and agents: CLAUDE.md, a CONTEXT.md glossary, ADRs, standards and a design-system folder, and audits drift with --check.
Zed Config
wcygan/dotfiles
Zed editor configuration expert. An agent skill from wcygan/dotfiles.
More from ninehills/skills
All 38 skills in this repoAlphaear Predictor
ninehills/skills
Market prediction skill using Kronos. An agent skill from ninehills/skills.
Alphaear Signal Tracker
ninehills/skills
Track finance investment signal evolution and update logic based on new finance market information.
Fireworks Tech Graph
ninehills/skills
A skill your agent uses when the user wants to create any technical diagram - architecture, data flow, flowchart, sequence, agent/memory, or concept map - and export as SVG+PNG.
Alphaear Sentiment
ninehills/skills
Analyze finance text sentiment using FinBERT or LLM. An agent skill from ninehills/skills.
Bggg Creator Image2ppt
ninehills/skills
把图片、截图、海报、PPT 页面截图、HTML 或 SVG 设计稿转换成可编辑 PPTX 的 Codex skill. An agent skill from ninehills/skills.
Bggg Creator Image2psd
ninehills/skills
把一张或多张图片整理成 PSD 图层文件的创作与转换 skill。当用户需要 image2psd、图片转 PSD、 多张图片拼成 PSD、海报/设计稿拆成多个图层、白底转透明、颜色聚类拆层、把 Codex/AI 生图结果拆成元素图再合成 PSD、 或希望输出 layered PSD、可在 Photoshop/Photopea 中编辑的分层栅格文件时，应该使用此 skill。
Related
Works with
Categories
Questions about Health
What does Health do?
Runs a budget-aware agent-assisted engineering health audit for instruction/config drift, hooks/MCP, verifier surfaces, and AI maintainability. Health is an agent skill from ninehills/skills. Runs a budget-aware agent-assisted engineering health audit for instruction/config drift, hooks/MCP, verifier surfaces, and AI maintainability.
When should I use Health?
Health fits situations like: users ask in any language to audit Claude; agent instructions; verifier coverage; AI-maintainability drift.
How do I install Health in Claude Code?
Run `npx skills add ninehills/skills --skill health -a claude-code`. Or copy the skill folder (health in ninehills/skills) into .claude/skills/health in your project. Claude Code loads it when a task matches its description.
How do I install Health in Codex?
Run `npx skills add ninehills/skills --skill health -a codex`. Or copy the skill folder (health in ninehills/skills) into .agents/skills/health in your project. Codex loads it when a task matches its description.
Can I use Health in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ninehills/skills --skill health -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/health, .gemini/skills/health, .github/skills/health and .opencode/skills/health in your project.
What does Health need to run?
Going by SKILL.md and its folder, Health needs a shell and Python for the scripts in its folder and the command-line tools its instructions call (bash, git, npx, curl, wget and sh). Our summary lists: Python 3; Node.js; A Bash shell.
Does Health access the network?
SKILL.md contains no URLs. Its commands use git, npx, curl, wget and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Health safe to install?
Our automated static check of SKILL.md flagged 1 warning(s): pipes a downloaded script straight into a shell. Read the flagged lines before installing; the check is not a guarantee either way. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Health use?
No licence was found for Health or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.
How many tokens does Health use?
About 5.4k tokens (SKILL.md is roughly 22k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Health?
Skills that share tags, products or a category with Health: Agent Setup Health Audit (tw93/Waza, 7.2k stars), Agnix (agent-sh/agnix, 445 stars), Agnix (agent-sh/agnix, 445 stars) and Bringup (jenissimo/bottleship, 152 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Health?
ninehills (a GitHub user) maintains it in ninehills/skills, which has 280 GitHub stars. The repository holds 38 skills in this directory. The repository was last updated on June 22, 2026.
Source: ninehills/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.