CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

axiom-resolve-spm

Use when the user mentions SPM resolution failures, "no such module" errors, duplicate symbol linker errors, version conflicts between packages, or Swift 6 package compatibility issues.

Quality

64%

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-resolve-spm/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.

The body is a strong, executable playbook: six conflict patterns each pair concrete detection commands with specific resolution strategies, an explicit audit sequence, and post-resolution verification. Its main weaknesses are redundancy (repeated reset commands, a very long output template) and a monolithic single-file layout that inlines reference material.

Suggestions

Consolidate the three repeated SPM reset instruction blocks (Pattern 4, the output template, and the commands reference) into one canonical reset procedure.

Move the full output-format template and the SPM/Xcode command reference into references/ files (e.g., references/output-format.md, references/commands.md) and keep only a skeleton plus pointers in SKILL.md.

Trim the 'Invocation Examples' section (it duplicates the description's triggers) and remove the padded `products: [...], dependencies: [...]` boilerplate from the Swift examples.

DimensionReasoningScore

Conciseness

Mostly efficient, command-dense content, but the destructive reset (rm -rf .build, rm Package.resolved, swift package resolve) appears three times (Pattern 4, the output template's 'Resolution Commands', and 'Common SPM Commands Reference'), and the ~130-line worked output template plus 'Invocation Examples' restate trigger guidance already in the description. Not 2 because most sections are concrete and unpadded; not 4 because the duplication and placeholder Swift boilerplate (products: [...]) are noticeable.

3 / 5

Actionability

Highly executable guidance: exact commands (swift package show-dependencies --format json, xcproject inspect --root ., a jq duplicate-pin pipeline with a no-jq fallback) and specific resolution edits per pattern. Minor gaps: Swift manifest snippets use [...] placeholders, and swift package diagnose-api-breaking-changes is offered as a generic 'check for issues/security advisories' tool, which slightly mischaracterizes it. Below anchor 5 for these gaps; well above 3.

4 / 5

Workflow Clarity

The Audit Process gives a clear Step 1→3 sequence (gather info, identify conflicts, analyze graph) and a Verification section closes the loop (clean build, swift test, grep warnings), so the destructive resets are followed by validation — the cap-3 rule for destructive operations without validation does not apply. Not 5 because the detect→fix→re-detect feedback loop is implicit and the 'nuclear option' cache wipe carries no pre-check caution.

4 / 5

Progressive Disclosure

A single ~480-line file with good section headers but no bundle: the full output-format template and the command reference are inline content that would fit better in separate reference files, and the only pointer is the external <plugin-root>/tools/xcproject. Matches anchor 3 (structure present, content that should be separate is inline); not 2 because sections are well-headed and navigable; not 4 because at this length the all-inline placement exceeds a minor gap.

3 / 5

Total

14

/

20

Passed

Description

47%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 lists specific, natural error phrases users would say, giving it good trigger quality and distinctiveness. However, it omits any statement of what the skill does, which drags down completeness and specificity.

Suggestions

Add a leading 'what' clause describing the concrete actions, e.g., 'Diagnoses and resolves Swift Package Manager dependency conflicts by analyzing Package.swift and Package.resolved. Use when...'.

Include a few more natural trigger variations and synonyms: 'Swift Package Manager' spelled out, 'Package.swift', 'packages won't resolve', and 'Swift 6 strict concurrency build errors'.

Clarify scope boundaries so "no such module" and duplicate-symbol errors from non-SPM causes (CocoaPods, build settings) don't trigger this skill incorrectly.

DimensionReasoningScore

Specificity

Names the domain concretely ("SPM resolution failures", "version conflicts between packages") but lists only trigger conditions, not actions — there is no statement of what the skill actually does. Anchor 3 requires 1–2 concrete actions, which are absent; it is above anchor 1 because the language is specific rather than pure abstraction.

2 / 5

Completeness

Only a "when" is present with no "what" — the description never says the skill diagnoses and resolves conflicts (e.g., by analyzing Package.swift and Package.resolved). This matches anchor 2 ("only 'when' is present without 'what'"); it is not 3 because the "what" is entirely missing, not merely weakly implied.

2 / 5

Trigger Term Quality

Includes natural phrases users would say: "no such module" errors, "duplicate symbol linker errors", "version conflicts between packages", "Swift 6 package compatibility issues". Missing a few natural variations ("Swift Package Manager" spelled out, "Package.swift", "packages won't resolve/update"), keeping it below the comprehensive-synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Swift Package Manager dependency conflicts) with distinct triggers, so conflict risk with other skills is low. "no such module" errors can also arise from CocoaPods or Xcode build-setting problems unrelated to SPM, a minor overlap that keeps it below anchor 5.

4 / 5

Total

12

/

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-resolve-spm/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.