CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

axiom-optimize-build

Use when the user mentions slow builds, build performance, or build time optimization.

Quality

60%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./axiom-codex/skills/axiom-optimize-build/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 strongly actionable, well-sequenced Xcode build audit workflow with exact commands, expected setting values, and good failure handling. Its weaknesses are redundancy (mission restated, UI walkthroughs, invocation examples), an unexplained $SETTINGS_JSON input, and a monolithic body that offloads nothing to reference files.

Suggestions

Collapse the mission statements (intro, "## Your Mission", "## Scope") into one section and delete the Invocation Examples block, which duplicates the description's triggers.

Define how $SETTINGS_JSON is produced (or replace it with a concrete capture command) so every listed command is actually runnable.

Move the build-settings catalog and Build Timeline walkthrough into a references/ file (e.g. references/settings-catalog.md) and keep SKILL.md as a scan-process overview with one-level-deep pointers.

DimensionReasoningScore

Conciseness

The body is mostly dense, useful checklists and commands, but there is real redundancy and padding: the mission is stated three times (intro "Your mission is to scan the project...", "## Your Mission", "## Scope"), the Invocation Examples section restates triggers already in the description, and the Build Timeline section walks through Xcode UI navigation (Report Navigator, Cmd+9, Assistant editor) that Claude already knows. It fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than 4, where over-explanation would be only minor.

3 / 5

Actionability

Guidance is largely executable: exact `xcproject settings`/`inspect` commands with all flags, exact setting names and expected values (e.g. `SWIFT_COMPILATION_MODE` = `singlefile` for Debug), a copy-paste timing-build snippet with exit-code handling, and a concrete ❌/✅ before/after fix. It stops short of 5 because `$SETTINGS_JSON` is passed to commands but never created or explained anywhere, and the `xcproject` fallback chain (plugin-root resolution, npx) is convoluted enough that a fresh run could stall.

4 / 5

Workflow Clarity

The Scan Process is a clearly sequenced 5-step workflow with specific commands per step, and validation checkpoints are present: fresh authorized capture vs. declared values, "do not infer missing settings as optimal defaults", pgrep inventory before running a build, exit-code-preserving failure handling, and "Always measure before and after". It does not reach 5 because there is no explicit feedback/re-validation loop after recommending fixes, and per-step output checks are implicit rather than a checklist.

4 / 5

Progressive Disclosure

The bundle contains no reference files at all (no references/, scripts/, assets/), and the ~215-line body inlines everything: a full build-settings catalog, phase-script red flags, timeline analysis, and output-format spec are all inline with only headers for navigation. The one cross-reference, `axiom-build (skills/build-performance.md)`, points to an external skill outside this bundle. This fits 'some structure but could be better organized; content that should be separate is inline' — good section structure keeps it above 2, but nothing is offloaded into one-level-deep reference files, so it cannot score 4.

3 / 5

Total

14

/

20

Passed

Description

36%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 a pure trigger clause: it says when to fire but never what the skill does. It reads naturally as a trigger but lacks any capability statement, platform qualifier, or keyword synonyms, capping completeness and specificity low.

Suggestions

Lead with a 'what' statement in third person, e.g. "Scans Xcode projects for build performance bottlenecks — suboptimal build settings, expensive build phase scripts, and slow type checking — and produces a prioritized optimization report."

Mention the platform explicitly (Xcode, .xcodeproj, Swift) so the skill doesn't trigger for users of other build systems.

Add common trigger synonyms such as "compile times", "builds take forever", or "speed up builds" to broaden natural-keyword coverage.

DimensionReasoningScore

Specificity

The description names the domain ("slow builds, build performance, or build time optimization") but contains no capability statement at all — no action verb, no mention of what the skill actually does (Xcode build auditing, settings analysis, script inspection). This names the domain with zero concrete actions, matching the score-2 anchor rather than score 1 (which requires entirely vague, abstract language), but it cannot reach 3 since not even one action is listed.

2 / 5

Completeness

The 'when' is explicit ("Use when the user mentions slow builds...") but the 'what' is entirely absent — the description never states what the skill does. This matches the score-2 anchor exactly ('only when is present without what', example: 'Use when working with documents') and is clearly below score 4/5, which require both a what and a when.

2 / 5

Trigger Term Quality

"slow builds" and "build performance" are natural phrases a user would say, but common variations are missing: no "compile times", no "builds take forever", no "speed up builds", and — critically for an Xcode-specific skill — no mention of Xcode, iOS, or macOS. This fits the anchor 'Some relevant keywords but missing common variations or synonyms' rather than 4, where keyword coverage would be good with only a few natural terms missing.

3 / 5

Distinctiveness Conflict Risk

The niche (build performance) is somewhat specific, but the description never mentions Xcode while the skill is exclusively Xcode-specific, so it would equally trigger for users needing Gradle, webpack, or Bazel build optimization. This overlaps with similar-sounding skills; not score 4 ("mostly distinct") because the platform qualifier is missing entirely.

3 / 5

Total

10

/

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-optimize-build/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.