swift-concurrency
Diagnose Swift Concurrency issues, refactor callback-based code to async/await, and guide Swift 6 migration when working with tasks, actors, @MainActor, Sendable, data races, thread safety, or concurrency-related compiler and linter warnings.
75
92%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that clearly defines its scope around Swift Concurrency, lists concrete actions (diagnose, refactor, guide migration), and provides rich trigger terms that developers would naturally use. The 'when working with...' clause effectively serves as explicit trigger guidance, and the domain-specific terminology ensures high distinctiveness.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Diagnose Swift Concurrency issues', 'refactor callback-based code to async/await', and 'guide Swift 6 migration'. These are clear, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('Diagnose Swift Concurrency issues, refactor callback-based code to async/await, and guide Swift 6 migration') and when ('when working with tasks, actors, @MainActor, Sendable, data races, thread safety, or concurrency-related compiler and linter warnings'). The 'when' clause is explicit with trigger conditions. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms a developer would use: 'async/await', 'tasks', 'actors', '@MainActor', 'Sendable', 'data races', 'thread safety', 'concurrency-related compiler and linter warnings', 'Swift 6 migration', 'callback-based code'. These are precisely the terms developers encounter and search for. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive niche targeting Swift Concurrency specifically. The combination of Swift-specific terms like '@MainActor', 'Sendable', 'actors', 'Swift 6 migration', and 'async/await' makes it very unlikely to conflict with other skills, even other Swift or general concurrency skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a high-quality skill that provides actionable, well-structured guidance for Swift Concurrency diagnostics and migration. Its strengths are the concrete diagnostic table with smallest-safe-fix recommendations, executable code examples, explicit validation loops, and excellent progressive disclosure via the Reference Router. The main weakness is some redundancy between sections (task entry isolation guidance appears twice with overlapping content), which slightly hurts conciseness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient and avoids explaining basic Swift concepts, but some sections are repetitive—task entry isolation guidance appears in both 'Smallest Safe Fixes' and a dedicated 'Task entry isolation' section with overlapping content. The Quick Fix Mode criteria and some table entries could be tightened. | 2 / 3 |
Actionability | The skill provides concrete, executable Swift code examples, specific compiler diagnostic strings with exact fix recommendations, a detailed settings lookup table with exact key names for both SwiftPM and Xcode, and a clear migration validation loop. Guidance is copy-paste ready and specific. | 3 / 3 |
Workflow Clarity | The Migration Validation Loop provides an explicit build→fix→rebuild→test cycle with a clear 'only proceed when clean' checkpoint. The Fast Path establishes a clear diagnostic sequence (check settings → capture diagnostic → determine isolation → confirm intent). The 'When Quick Fixes Fail' section provides an escalation path. Verification checklist adds further validation steps. | 3 / 3 |
Progressive Disclosure | The Reference Router section provides a well-organized, one-level-deep directory of reference files grouped by topic (Foundations, Streams, Applied topics, Migration/tooling, Glossary). The main SKILL.md serves as a clear overview with actionable quick-fix content, routing to specific reference files for deeper dives. Navigation is easy and clearly signaled. | 3 / 3 |
Total | 11 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- avdlee/swift-concurrency-agent-skill
- Commit
faa595e
- 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.