CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

health

Audits agent config, instruction drift, hooks or MCP, and AI maintainability. Use when Claude, Codex, or Pi setup looks wrong. Not for application bugs or PR review.

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/health/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-engineered audit skill with exceptional actionability — exact commands, a strict copy-pasteable finding format, and genuine validation checkpoints like inspector reconciliation and coverage receipts. Its weaknesses are density and a dangling set of agents/inspector-*.md references that the deep-audit workflow depends on.

Suggestions

Break the Step 1c 'Deny-list floor', 'Budget posture', and 'Conversation scope' paragraphs into short bullet lists or move the calibration details into a references/ file; each currently buries 5-10 distinct rules in one run-on block.

Fix or ship the agents/ directory: Step 2 routes deep audits to agents/inspector-context.md, inspector-control.md, and inspector-maintainability.md, none of which exist in the bundle, so the primary deep-audit path is unresolvable as shipped.

Deduplicate the Windows launcher invocation (given in full in both Step 1 and Step 2) by referencing $HEALTH_LAUNCHER/$HEALTH_SCRIPT resolved in Step 1, and add one or two concrete sentences on how summary-mode analysis proceeds before findings are written.

DimensionReasoningScore

Conciseness

The body is dense with rules and almost never explains concepts Claude already knows, but several sections are wall-of-text paragraphs that could be materially tightened — the Step 1c 'Deny-list floor' paragraph, 'Budget posture', and 'Conversation scope' each pack many conditions into single run-on blocks, and the PowerShell launcher command is repeated in Step 2. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than anchor 4, where only minor trimming would be needed.

3 / 5

Actionability

Guidance is fully executable: copy-paste Bash and PowerShell blocks with candidate-path fallback and explicit failure exits ('BASH_ENV= ENV= /bin/bash -p "$HEALTH_SCRIPT" "$HEALTH_SCOPE"'), an exact finding format with a worked example, a mandated copy-pasteable 'Action:' line ('Never write "investigate X"... name the diagnostic command'), and concrete severity definitions. Not below 5: no pseudocode or vague directives remain; the '<skill-base-dir>' placeholder is resolved by the included fallback logic.

5 / 5

Workflow Clarity

Steps 0→1→1b→1c→2 are clearly sequenced with real checkpoints: '(unavailable)' sections are defined as insufficient data rather than findings, deep audits must 'wait for every launched inspector and reconcile its assigned scope', and the Gotchas table gives error-recovery rules. Not 5: the summary-mode analysis step itself is thin ('Analyze locally from the summary output by default') and defers detail to references, and the escalation feedback loop is stated as policy rather than as an explicit validate-and-branch step.

4 / 5

Progressive Disclosure

References are one level deep, clearly signaled with purpose ('load references/long-running-agents.md and audit the four hard stop signals it lists'), and all three files in references/ exist with real content; the large scripts/ bundle is appropriately kept out of the body. Not 5: the three 'agents/inspector-*.md' paths cited in Step 2 do not exist in the shipped bundle (no agents/ directory), leaving dangling navigation for the deep-audit path, and some inline policy blocks (deny-list calibrations, instruction-drift rules) are long enough to belong in references.

4 / 5

Total

16

/

20

Passed

Description

78%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that states a concrete multi-surface audit scope, an explicit use-when clause naming the three runtimes, and explicit exclusions that sharply reduce conflict risk. Its only shortcoming is that the trigger clause is a single informal condition rather than a fuller set of concrete trigger phrases.

DimensionReasoningScore

Specificity

The description enumerates several specific audit surfaces — 'agent config, instruction drift, hooks or MCP, and AI maintainability' — which is broader than anchor 3's '1-2 concrete actions'. Not 5: it names domains rather than comprehensive concrete actions (e.g., permissions, memory/skill supply chain, verifier coverage are only discoverable in the body).

4 / 5

Completeness

Both parts are explicitly present: what ('Audits agent config, instruction drift, hooks or MCP, and AI maintainability') and when ('Use when Claude, Codex, or Pi setup looks wrong'), plus a negative boundary. Not 5: the when-clause is a single colloquial condition ('setup looks wrong') rather than the multiple concrete trigger phrases of the anchor-5 example, so it 'could be more explicit or specific' per anchor 4.

4 / 5

Trigger Term Quality

Strong natural triggers are present: 'Claude, Codex, or Pi setup looks wrong' plus 'hooks or MCP' gives good keyword coverage users would actually say. Not 5: common phrasings like 'settings', 'agent instructions', or 'ignoring instructions' are missing from the description field itself (they appear only in the separate when_to_use field, which is not the evaluated target).

4 / 5

Distinctiveness Conflict Risk

A clear niche — agent configuration and AI-maintainability audits for named runtimes — with explicit disambiguation ('Not for application bugs or PR review') that prevents overlap with code-review and debugging skills. It matches anchor 5's 'clear niche with distinct triggers; minimal conflict risk' and is more self-disambiguating than the anchor-4 example, which lacks exclusions.

5 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

tw93/Waza

Path

skills/health/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.