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

80%

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-cursor/skills/axiom-concurrency/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 well-conceived router skill with concrete symptom-to-reference mapping, cross-skill conflict resolution, and an unusually useful anti-rationalization table. Its two real weaknesses are redundant repetition of the routing map across four sections, and that none of the referenced skills/*.md files are present in the bundle, leaving the progressive-disclosure chain unresolvable.

Suggestions

Consolidate the routing into a single canonical form (e.g. keep the Quick Reference table and one decision list) and drop the duplicate dot-graph decision tree and/or the Example Invocations section, which repeat the same symptom→file mapping.

Ship the referenced files (skills/swift-concurrency.md, swift-concurrency-ref.md, synchronization.md, assume-isolated.md, isolation-inheritance-diag.md, concurrency-profiling.md) in the skill's bundle, or fix the paths so each reference resolves one level deep from SKILL.md.

Trim the 'Critical Patterns' section to one-line pointers per referenced file instead of multi-bullet summaries, letting the referenced files carry their own content.

DimensionReasoningScore

Conciseness

The symptom→file routing map is repeated four times in different formats (Quick Reference table, dot-graph decision tree, numbered decision list, and Example Invocations), and the 'Critical Patterns' section further summarizes the contents of the referenced files. This is genuinely useful routing content, but the duplication is more than the 'minor instances of over-explanation' the 4-anchor allows and could be tightened to one or two formats.

3 / 5

Actionability

Routing guidance is concrete and executable — exact file paths per symptom ("Read: skills/swift-concurrency.md"), exact crash signatures (_dispatch_assert_queue_fail, _swift_task_checkIsolatedSwift), explicit MCP tool mappings (xclog launch → axiom_xclog_launch), and a failure path ('If a required MCP tool is unavailable, stop and report'). It falls short of fully copy-paste-ready guidance, and the routing targets themselves do not resolve within the provided bundle.

4 / 5

Workflow Clarity

The decision process is clearly sequenced (decision tree plus numbered decision list covering symptom classes, with cross-skill conflict-resolution ordering like 'Try concurrency FIRST' before axiom-performance) and includes an explicit failure checkpoint for the MCP boundary. No validation steps are required for non-destructive routing, so the anchor-5 feedback loops are not applicable, but a couple of decision-tree branches overlap ambiguously.

4 / 5

Progressive Disclosure

The routing structure itself is well-signaled and one level deep (table + decision tree + per-file summaries), but every referenced path — skills/swift-concurrency.md, skills/swift-concurrency-ref.md, skills/synchronization.md, skills/assume-isolated.md, skills/isolation-inheritance-diag.md, skills/concurrency-profiling.md, plus cross-skill references — is absent from the bundle (no references/, scripts/, assets/, or skills/ directories exist), so the disclosure chain is broken and unverifiable as shipped.

3 / 5

Total

14

/

20

Passed

Description

87%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, well-scoped trigger clause and concrete Swift-specific terminology that makes it highly distinguishable. The only weakness is that the 'what' is phrased as topic coverage ('Covers...') rather than concrete capability actions, and a few common user phrasings (e.g. 'threading', 'main thread') are absent.

DimensionReasoningScore

Specificity

The description lists several concrete items — "Covers Swift 6 concurrency, @MainActor, Sendable, data races, async/await patterns" — but 'Covers' is a scope verb enumerating topics rather than concrete capability actions (cf. the 5-anchor's 'Extract text... fill forms... merge documents'), leaving minor gaps in what the skill actually does with those topics.

4 / 5

Completeness

Both halves are explicitly present: an explicit trigger clause ("Use when writing ANY async code, actors, or threads in an Apple-platform app, or seeing ANY concurrency error") with concrete trigger phrases, and a clear 'what' ("Covers Swift 6 concurrency, @MainActor, Sendable, data races, async/await patterns"). The 4-anchor ('when' could be more explicit) does not fit because the 'when' is already maximally explicit.

5 / 5

Trigger Term Quality

Good natural-keyword coverage — "async code", "actors", "threads", "data races", "async/await", "Swift 6", "concurrency error" are phrases users would naturally say — but common variations like "threading", "main thread", "Task", or "TaskGroup" are missing, so it falls just short of the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche via platform- and language-specific terms — "Apple-platform app", "Swift 6 concurrency", "@MainActor", "Sendable" — that no generic or neighboring skill would share, giving minimal conflict risk.

5 / 5

Total

18

/

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-cursor/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.