CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

axiom-concurrency

Use when writing ANY async code, actors, or threads in an Apple-platform app, or seeing ANY concurrency error. Covers Swift 6 concurrency, @MainActor, Sendable, data races, async/await patterns.

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 ./.claude-plugin/plugins/axiom/skills/axiom-concurrency/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 skill: concrete symptom-indexed routing, explicit cross-skill conflict resolution, and genuinely valuable Swift 6.2 specifics in the Anti-Rationalization table. Its weaknesses are the same routing information repeated in four formats and referenced files that are not resolvable within the provided bundle.

Suggestions

Collapse the routing duplication: the Quick Reference table, the dot graph, the numbered Decision Tree, and Example Invocations all restate the same symptom-to-file mapping — keep at most two of these formats to cut roughly a third of the body.

Make the referenced paths resolvable from the skill itself: state explicitly where skills/*.md live relative to this SKILL.md, and verify each referenced file (including the concurrency-auditor and cross-suite axiom-* references) exists in the distributed bundle.

Move the dense NonisolatedNonsendingByDefault/SWIFT_APPROACHABLE_CONCURRENCY paragraph in the Anti-Rationalization table into skills/swift-concurrency.md, keeping only the one-line takeaway ('nonisolated async does not guarantee a background thread — check isolation') in the table.

DimensionReasoningScore

Conciseness

The body doesn't explain basics Claude already knows and the Anti-Rationalization table carries genuinely non-obvious Swift 6.2 specifics, but the same symptom-to-file routing is restated in four formats (Quick Reference table, dot graph plus numbered Decision Tree, Critical Patterns, Example Invocations). That is more than 'some' unnecessary duplication, yet not severe padding, matching the 3 anchor ('mostly efficient but could be tightened').

3 / 5

Actionability

Routing guidance is concrete and executable ('Read: skills/isolation-inheritance-diag.md', '/axiom:audit concurrency', 'xcprof analyze --start-ms/--end-ms --user-binary') with user-example mappings covering common cases. It falls short of 5 because the referenced skills/*.md files are not present in the provided bundle, so the primary instruction cannot be verified to resolve.

4 / 5

Workflow Clarity

The routing workflow is a clear, well-sequenced decision tree, and the Conflict Resolution section provides explicit ordering checkpoints ('Try concurrency FIRST — Main thread blocking is the #1 cause... Only use axiom-performance if concurrency fixes don't help'). It is not a 5 because there is no guidance for the case where no branch matches, and the duplicated routing formats add mild ambiguity about which list is authoritative.

4 / 5

Progressive Disclosure

The skill is structured as a clean overview router with one-level-deep, symptom-indexed references, which fits the 5 anchor's shape. However, the referenced paths (skills/swift-concurrency.md etc.) are not part of this bundle (no references/ or skills/ files provided) and their base location is only indirectly defined via the '<plugin-root>' indirection, so navigation cannot be fully verified — matching the 4 anchor's 'minor organization gaps'.

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 strong description with an explicit, concrete 'Use when' trigger clause and good natural-keyword coverage scoped tightly to Apple-platform concurrency. The main gap is that the 'what' enumerates topic areas rather than concrete actions, which keeps it just below the top anchors.

DimensionReasoningScore

Specificity

The description enumerates several specific coverage areas ('Covers Swift 6 concurrency, @MainActor, Sendable, data races, async/await patterns'), which exceeds the 1-2 concrete actions of the 3 anchor. It stays at 4 rather than 5 because these are topic labels rather than concrete actions (e.g., 'diagnose runtime isolation crashes', 'migrate DispatchQueue to actors'), leaving minor gaps in capability coverage.

4 / 5

Completeness

It explicitly answers 'when' with concrete triggers ('Use when writing ANY async code, actors, or threads in an Apple-platform app, or seeing ANY concurrency error') and answers 'what' via scope ('Covers Swift 6 concurrency, @MainActor, Sendable, data races, async/await patterns'). It is not a 5 because the 'what' states topics covered rather than what the skill does with them, matching the 4 anchor's 'when' could be more explicit / what less action-oriented.

4 / 5

Trigger Term Quality

Natural user phrases are well covered: 'async code', 'actors', 'threads', 'concurrency error', 'data races', 'async/await' — all things a user would actually say. It falls short of the 5 anchor because common variations like 'main thread blocking', 'thread-safe', 'Task', or 'background thread' are absent.

4 / 5

Distinctiveness Conflict Risk

The description is scoped to 'an Apple-platform app' and uses platform-specific terms (@MainActor, Sendable, Swift 6), establishing a clear niche with distinct triggers and minimal conflict risk with generic skills.

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

.claude-plugin/plugins/axiom/skills/axiom-concurrency/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.