CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

axiom-run-tests

Use when the user wants to run XCUITests, parse test results, view test failures, or export test attachments.

Quality

81%

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

SKILL.md
Quality
Evals
Security

Quality

Content

77%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, well-validated runbook: executable commands cover discovery, execution, parsing, attachment export, and error recovery, with explicit checkpoints for a batch operation. Its weaknesses are token efficiency (duplicated process-management guidance and verbose axbuild internals) and the absence of any progressive disclosure — all reference-worthy material is inlined in one long file. Strong execution guidance undermined modestly by bloat and monolithic structure.

Suggestions

Deduplicate the process-management guidance: the pgrep inventory appears both in the shared section and in Mandatory First Steps, and the detailed description of axbuild's descendant-process cleanup could be condensed to the operational rule (never terminate unrelated processes; inspect ownership).

Move Common Failure Patterns, the Error Quick Reference table, and the Invocation Examples into a references/ file (e.g. references/failure-patterns.md) linked from SKILL.md, keeping the main file as a lean overview with the core run/parse/export workflow.

Tighten the shared axbuild section's multi-environment resolution prose (Claude Code/Codex/Pi/Cursor/MCP cases) into a short decision table or a single fallback rule, since the current paragraph repeats the same verification requirement in several forms.

DimensionReasoningScore

Conciseness

The body is command-dense rather than concept-explaining, but the shared axbuild/process-management section is verbose, the pgrep inventory ("pgrep -lx xcodebuild; echo \"pgrep exit=$?\"") appears twice (once in the shared section, once in Mandatory First Steps), and details of axbuild's internal cleanup behavior run longer than an executing agent needs. This matches anchor 3 (mostly efficient with some unnecessary explanation that could be tightened) rather than anchor 4's minor-trim profile.

3 / 5

Actionability

Nearly everything is copy-paste-ready executable bash: scheme discovery via "xcodebuild -list -json" with jq extraction, booted-simulator UDID resolution, fresh mktemp run directories per run, full xcodebuild test invocations (single class/method, skip-testing), and the complete xcresulttool surface (summary, tests, test-details, export attachments with --only-failures, coverage, console logs) plus a manifest-reading command and an error-to-fix table. This matches anchor 5's fully executable, common-case-covering profile.

5 / 5

Workflow Clarity

The sequence (mandatory checks → run → parse → analyze → report) is explicit and paired with genuine validation checkpoints: pgrep exit-code semantics before every Xcode invocation, verifying AXBUILD by running "--help" before use, the booted-simulator check, and rules like "A null failed-test count means uncertainty, not zero" and truncation-marker detection. Error-recovery feedback loops exist (saved-log fallback instead of rebuilding, failure-pattern diagnosis with quick fixes, the error quick reference), so this is a batch operation with validation present and matches anchor 5 rather than anchor 4's minor-validation-gaps profile.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), so everything — the ~90-line shared axbuild block, Common Failure Patterns, the error quick reference table, and invocation examples — is inlined in a single ~370-line SKILL.md. Section structure is decent, but content that clearly belongs in separate reference files is inline and there are no in-bundle references to signal, matching anchor 3 rather than anchor 4's mostly-appropriate placement with clear references.

3 / 5

Total

16

/

20

Passed

Description

75%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 is concise, in third person, and uses a well-formed "Use when" trigger clause enumerating four concrete capabilities. Its main limitation is that the 'what' is only implied through the trigger list and natural synonyms like "UI tests" or "xcresult" are absent. Overall a solid, low-conflict description for a clearly scoped skill.

DimensionReasoningScore

Specificity

"run XCUITests, parse test results, view test failures, or export test attachments" names the domain plus four concrete actions, matching the anchor for several specific actions with minor gaps (no mention of tooling like xcodebuild/xcresulttool, coverage, or simulator handling that the body actually covers). It falls short of anchor 5's comprehensive coverage and clearly above anchor 3, which expects only 1-2 concrete actions.

4 / 5

Completeness

The explicit "Use when..." clause with four concrete trigger phrases answers 'when' clearly, and the enumerated actions convey 'what', but the 'what' is only embedded in the trigger list rather than stated as a standalone capability sentence like anchor 5's example structure. This sits above anchor 3 (where 'when' is weak or missing) and matches anchor 4's 'both present, could be more explicit'.

4 / 5

Trigger Term Quality

Natural phrases users would say are present ("run XCUITests", "parse test results", "view test failures", "export test attachments"), but common variations such as "UI tests", "xcresult", or "screenshots" are missing — good coverage with a few natural terms absent, matching anchor 4 rather than anchor 5's synonym-and-extension completeness.

4 / 5

Distinctiveness Conflict Risk

"XCUITests" establishes a clear iOS UI-testing niche with concrete triggers, so it is mostly distinct, but "parse test results" and "view test failures" are generic enough to overlap with closely related testing skills (the body itself references an axiom-testing skill). Minor overlap risk matches anchor 4 rather than anchor 5's minimal-conflict profile.

4 / 5

Total

16

/

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-run-tests/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.