CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

axiom-health-check

Use when the user wants a comprehensive project-wide audit, full health check, or scan across all domains.

Quality

75%

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 ./axiom-codex/skills/axiom-health-check/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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.

The body is a highly actionable orchestration playbook: exact globs, grep signals, file templates, a verbatim scope block, explicit failure handling, and hard scope-boundary enforcement across clearly sequenced phases, with detail properly delegated to sibling skills via a mapping table. Its weaknesses are modest — some padded sections (invocation examples, Related, closing Scope) and sibling-skill references that cannot be verified against the actual bundle. Overall it provides copy-paste-ready operational guidance.

DimensionReasoningScore

Conciseness

Core content is dense and operational (the signal→auditor grep table, the verbatim DIFF SCOPE block, "Today's date tag for filenames: use ISO format `YYYY-MM-DD`"), but several sections are removable padding: "This makes it unambiguous to the reader (and to any PR reviewer pasting the report into a comment)..." explains rationale Claude doesn't need, the three trivial Invocation Examples ("user: 'Run a health check on my project' / assistant: [Launches health-check agent]") teach nothing, and the closing "## Scope" section restates the opening paragraph. This matches anchor 3 (mostly efficient, some unnecessary explanation that could be tightened) — not 2, since there is no concept-teaching padding, and not 4, because the invocation-examples/Related/Scope sections are noticeable slack rather than minor instances.

3 / 5

Actionability

Every phase carries exact, executable guidance: the glob ("Glob `**/*.swift`"), precise grep patterns ("`Timer.scheduledTimer` or `CLLocationManager`"), concrete output paths ("`scratch/health-check-{area}-{date}.md`"), a copy-paste-ready verbatim scope block ("Only audit the files listed below. Do NOT report findings outside this list..."), exact report formats ("` Scope: changed files vs `<base>` (merge-base `<short-SHA>`, N files) `"), a hard threshold ("If >100 total findings"), and a complete 28-row auditor→skill path mapping. Per the scoring notes for instruction-only skills, this is copy-paste-ready guidance with no meaningful gaps, matching anchor 5.

5 / 5

Workflow Clarity

Phases 0–4 are explicitly sequenced with validation checkpoints and feedback loops throughout: "obtain a verified `DIFF SCOPE` block before auditing; do not fall back to a full audit", "Wait for all selected audits to finish or have a recorded failure before proceeding. A failure or unavailable capability is not a passed audit", error recovery ("If an auditor fails or times out, note it in the report and continue with others"), post-hoc scope verification ("drop any finding whose file path is not in the Phase 0 file list before deduplicating"), and bounded-batch capacity management for delegation. This matches anchor 5 (clear sequence, explicit validation, feedback loops, checklists); anchor 4 falls short because validation here is explicit and repeated, not merely present.

5 / 5

Progressive Disclosure

The body correctly delegates all per-domain procedure detail to one-level-deep sibling skills via a clearly signaled mapping table ("`memory-auditor` → `axiom-audit-memory` (`../axiom-audit-memory/SKILL.md`)"), keeping the orchestrator self-contained. However, no bundle files exist in this skill's directory (no references/, scripts/, assets/), and none of the referenced `../axiom-*` paths resolve on disk, so the references cannot be verified; sections like Invocation Examples and Related are inline filler. This matches anchor 4 (good structure, references mostly clear, minor organization gaps) rather than 5 (references unverifiable, some inline content should move or go), and clearly above 3 (the mapping table is a well-signaled shallow reference pattern).

4 / 5

Total

17

/

20

Passed

Description

56%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.

The description has an explicit, naturally phrased 'Use when' trigger clause with good user-facing keywords, but it never states what the skill actually does — the orchestration of specialized auditors, file:line deduplication, and unified report generation are all invisible from the description alone. Specificity and completeness are the main weaknesses, leaving the description vague despite its clear triggers.

Suggestions

Add a concrete 'what' clause naming the actual actions, e.g., "Runs specialized auditor procedures (memory, security, accessibility, performance, etc.), deduplicates findings by file:line, and produces a unified health report."

Broaden trigger coverage with natural variations users actually say, such as "audit my codebase", "check my project for issues", or "full project review".

Name the target platform (iOS/Swift projects) to sharpen distinctiveness against generic audit, lint, and code-review skills.

DimensionReasoningScore

Specificity

Phrases like "comprehensive project-wide audit", "full health check", and "scan across all domains" name the domain but use only generic activity nouns; the description never states a concrete action (running specialized auditor procedures, deduplicating findings by file:line, producing a unified report). This matches anchor 2 ("Names the domain but actions are minimal or generic") rather than 3, which requires 1-2 concrete actions, and not 1, since it is not pure abstract language.

2 / 5

Completeness

The "when" is explicit ("Use when the user wants a comprehensive project-wide audit..."), but the "what" is only vague — "audit / health check / scan" restates the trigger instead of describing what the skill does. This sits between anchor 2 (vague what, no when — inapplicable since when is present) and anchor 4 (both present — inapplicable since the what is too vague to count), so it lands at 3 by boundary guidance.

3 / 5

Trigger Term Quality

"comprehensive project-wide audit", "full health check", and "scan" are natural phrases users say (matching the body's own invocation examples like "Run a health check on my project"), giving good keyword coverage. It falls short of anchor 5 because common variations such as "audit my codebase", "check my project for issues", or "full project review" are missing, but exceeds anchor 3 since the terms present are exactly what users would naturally say.

4 / 5

Distinctiveness Conflict Risk

Qualifiers "project-wide", "full", and "across all domains" clearly distinguish this orchestrator from the 28 single-domain auditor skills in the same family ("Works with PDF and Word document files"-level distinctness). It is not anchor 5 because bare trigger words like "scan" remain somewhat broad and the skill family contains many closely related auditors that a plain "audit my project" request could match instead.

4 / 5

Total

13

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

CharlesWiltgen/Axiom

Path

axiom-codex/skills/axiom-health-check/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.