CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

axiom-performance

Use when an Apple-platform app feels slow, memory grows, battery drains, or ANY performance issue needs diagnosing. Covers memory leaks, profiling, Instruments workflows, retain cycles, optimization.

Quality

71%

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

Quality

Content

52%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 genuinely useful router with an excellent decision tree, a strong anti-rationalization table, and a correct one-level-deep reference structure. Its main flaws are duplication — Example Invocations and Critical Patterns largely restate the Decision Tree and Routing Logic — inconsistent destination naming, and unresolvable sub-skill paths, which together cost both tokens and execution certainty.

Suggestions

Cut the ~130-line 'Example Invocations' section (and fold 'Critical Patterns' into Routing Logic): both restate the Decision Tree nearly entry-for-entry; keep only the handful of genuinely ambiguous cases (e.g. the memory-plus-stutter and first-launch-hang pairs) as inline examples.

Pick one canonical name per destination and use it everywhere: 'axiom-audit-memory' vs 'memory-auditor (Agent)' vs 'memory-auditor' (and the energy/swift-perf equivalents) currently name the same target three ways across Routing Logic, the Decision Tree, and the Codex inline block.

Move version-sensitive details ('OS27', 'iOS 26', 'iOS 13–26', 'the 27 cycle') out of the router into the referenced sub-files (or a single versioned section), so the router body stays version-agnostic and doesn't age.

DimensionReasoningScore

Conciseness

Noticeably verbose for a router: the ~130-line "Example Invocations" section restates the Decision Tree entry-for-entry (e.g. "User: 'My app's memory usage keeps growing' → See skills/memory-debugging.md" duplicates Decision Tree item 2), "Critical Patterns" re-summarizes sections already described in Routing Logic, and inline version markers ("OS27", "iOS 26", "iOS 13–26", "the 27 cycle") appear throughout rather than being isolated in a versioned/deprecated section. This matches anchor 2 — several padded sections — better than anchor 3, since roughly half the body is a second or third restatement of the same routing map.

2 / 5

Actionability

Routing decisions themselves are concrete and specific ("Memory leak scan → axiom-audit-memory (5-phase semantic audit...)", "xcprof compare --fail-on-regression (non-zero exit)"), but execution is incomplete: the destinations "See skills/memory-debugging.md" cannot be resolved — no skills/, references/, or scripts/ files exist in the bundle — and destination naming is inconsistent, with the same target called "axiom-audit-memory", "memory-auditor (Agent)", and "memory-auditor" in different sections. Matches anchor 3: concrete guidance with missing key details; not anchor 4, whose guidance is fully executable as written.

3 / 5

Workflow Clarity

The Decision Tree is a well-sequenced triage with conditionals and even a feedback loop ("memory-debugging FIRST ... then performance-profiling if memory is fixed but stutter remains") and ordering rules, and the Anti-Rationalization table doubles as error-recovery guidance. Below anchor 5 because of real friction: inconsistent agent names across sections, non-monotonic numbering (10/10a/10b/10c, 14/14a), and no checkpoint telling Claude what to do when a referenced sub-skill file is unavailable.

4 / 5

Progressive Disclosure

The router pattern is sound: every detailed topic is deferred one level deep with clearly signaled references ("See skills/hang-diagnostics.md", "See axiom-build (skills/lldb.md)"), and section headers (When to Use, Routing Logic, Decision Tree, Anti-Rationalization) make navigation easy. Not anchor 5 because the referenced paths are not part of this bundle (no skills/ directory exists alongside SKILL.md), and the same routing map is spread across three parallel sections, so content placement is only 'mostly' appropriate.

4 / 5

Total

13

/

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 with an explicit and natural trigger clause and a well-niched Apple-platform scope. The 'what' half is a slightly padded topic list ending in the generic 'optimization' rather than a crisp action inventory, and it omits hang/freeze/lag synonyms that the body itself treats as first-class triggers.

DimensionReasoningScore

Specificity

Names the domain ("Apple-platform app") and lists several specific capability areas — "memory leaks, profiling, Instruments workflows, retain cycles" — with only a generic tail ("optimization"). It sits between anchor 3 (1-2 concrete actions) and anchor 5 (comprehensive multi-action list): broader than 3, but the items are topics under 'Covers' rather than explicit actions like 'Diagnose memory leaks' and 'optimization' adds no specificity, so 4 fits better than 5.

4 / 5

Completeness

Both halves are explicit: "Use when an Apple-platform app feels slow, memory grows, battery drains, or ANY performance issue needs diagnosing" (when, with concrete triggers) and "Covers memory leaks, profiling, Instruments workflows, retain cycles, optimization" (what). It falls short of anchor 5 because the 'what' is a bare topic list with the vague 'optimization' rather than the clearly stated concrete actions the anchor-5 exemplar shows; it is clearly stronger than anchor 4's weak/implied 'when'.

4 / 5

Trigger Term Quality

Natural user phrasings are present: "app feels slow", "memory grows", "battery drains", "memory leaks", "retain cycles", "Instruments". Not a 5 because common variations users actually say are missing — 'laggy', 'hangs', 'freezes', 'janky', 'device gets hot' — none of which appear even though the body routes on them.

4 / 5

Distinctiveness Conflict Risk

Clear niche — Apple-platform (iOS/macOS) performance diagnosis with distinctive platform terms ("Instruments workflows", "retain cycles") — and triggers that would not fire for unrelated skills. Matches anchor 5: distinct triggers, minimal conflict risk.

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

CharlesWiltgen/Axiom

Path

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