CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

axiom-tools

Use when asking about Axiom skills or axbuild build/test capture, xclog console, xcsym .ips/MetricKit/.crash symbolication, xcui simulator UI/accessibility, or xcprof xctrace/CPU profiles.

Quality

77%

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-tools/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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-structured router whose routing table and resources section provide genuinely actionable, well-signaled navigation to per-tool references. Its main weaknesses are the large inlined generic routing-discipline block and the Device Hub duplication, which bloat the token budget, plus references that point to files outside the skill's own bundle.

Suggestions

Move the 'Using Axiom Skills' session-start block into a shared reference file and keep a one-line pointer, cutting roughly 90 lines of inlined generic routing rules.

Trim the Device Hub paragraph to a two-sentence summary plus the existing pointer, since the subcommand matrix and status-bar details already live in skills/device-control-ref.md.

Add one concrete example invocation per tool (e.g. a sample 'xclog' capture command) in the Resources list to make the routing immediately executable.

DimensionReasoningScore

Conciseness

The routing table and Resources section are lean, but the ~95-line inlined 'Using Axiom Skills' block pads with emphatic repetition ('This is not negotiable. This is not optional. You cannot rationalize your way out of this.') and a rationalization table, and the Device Hub paragraph restates details that the pointer says live in skills/device-control-ref.md. Mostly efficient with sections that should be tightened, matching anchor 3; not anchor 2 because the core routing content is dense and earns its tokens.

3 / 5

Actionability

Concrete, executable guidance throughout: a fallback path rule ('use `<plugin-root>/tools/<tool>` in place of the bare name'), a question-to-reference routing table with a specific command ('xcui resize sweep'), and named per-tool pointers. Minor gaps — most tools get no example invocation and the `<plugin-root>` resolution rule is convoluted — keep it at anchor 4 rather than 5.

4 / 5

Workflow Clarity

The router's decision flow is clear: check tool availability, route the question via the table to a specific file/section, and the priority ordering (environment → architecture → implementation) plus the multi-domain rule ('invoke ALL relevant routers') sequence decisions well. No validation checkpoints exist, but this router performs no destructive or batch operations, so the cap does not apply; it stays at 4 because the overall read-then-route sequence is implicit rather than stated as steps.

4 / 5

Progressive Disclosure

Good structure: an overview with a routing table mapping questions to one-level-deep, clearly signaled references (skills/xclog-ref.md, skills/xcsym-ref.md, etc.). It falls short of anchor 5 because the ~95-line generic session-start block is inlined rather than kept in its own file, and the referenced skills/*-ref.md files are not present in this skill's bundle (no references/ directory), leaving some pointers unverifiable.

4 / 5

Total

15

/

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 specific, well-scoped description with explicit trigger guidance and concrete per-tool capabilities, held back only by unmentioned routing targets (device control, screenshots) and an implicit rather than stated 'what'. Third person is used correctly and it is concise without padding.

Suggestions

Add the missing routed capabilities to the trigger list, e.g. 'device-control/devicectl simulator and device management, screenshots and status-bar overrides'.

State the 'what' explicitly, e.g. 'Routes Axiom tool questions to per-tool reference docs. Use when asking about...'.

Include a common user phrasing like 'crash report' or 'screenshot' alongside the tool-specific terms to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

The description lists several concrete tool-function pairs — 'axbuild build/test capture', 'xcsym .ips/MetricKit/.crash symbolication', 'xcui simulator UI/accessibility', 'xcprof xctrace/CPU profiles' — but omits capabilities the skill actually routes (device-control/devicectl, screenshots, xcproject), so coverage has minor gaps. It is above anchor 3 because more than 1-2 concrete actions are named, but below anchor 5 because the coverage is not comprehensive.

4 / 5

Completeness

The 'when' is explicit ('Use when asking about Axiom skills or axbuild...') and a functional 'what' is embedded via the enumerated tool capabilities, but the description never explicitly states what the skill does (route/onboard to per-tool reference docs). Both are present with one less explicit — matching anchor 4 rather than anchor 5's fully explicit what-and-when, and clearly above anchor 3 where 'when' would be missing.

4 / 5

Trigger Term Quality

Good natural-term coverage including file extensions and framework names users would say ('.ips', 'MetricKit', '.crash', 'symbolication', 'simulator UI/accessibility', 'CPU profiles'), but common phrasings like 'screenshot', 'Device Hub', 'devicectl', or 'crash report' are missing. It does not reach anchor 5's comprehensive synonym coverage, and clearly exceeds anchor 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

A clear niche — the Axiom bundled tool suite (axbuild, xclog, xcsym, xcui, xcprof) — with distinct trigger terms and minimal overlap risk; it is scoped away from the domain routers (axiom-build, axiom-swiftui) by naming the tools themselves. Matches anchor 5; no generic language that would fire for unrelated skills.

5 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 9 missing

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

CharlesWiltgen/Axiom

Path

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