CtrlK
BlogDocsLog inGet started
Tessl Logo

swift-expert

Builds iOS/macOS/watchOS/tvOS applications, implements SwiftUI views and state management, designs protocol-oriented architectures, handles async/await concurrency, implements actors for thread safety, and debugs Swift-specific issues. Use when building iOS/macOS applications with Swift 5.9+, SwiftUI, or async/await concurrency. Invoke for protocol-oriented programming, SwiftUI state management, actors, server-side Swift, UIKit integration, Combine, or Vapor.

72

Quality

88%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a solid, well-structured Swift skill with excellent actionability through concrete code examples and a clear workflow with validation checkpoints. Its main weaknesses are moderate verbosity in the constraints section (listing things Claude already knows) and referencing five bundle files that don't actually exist, undermining the progressive disclosure structure. The code patterns section is the strongest part, providing genuinely useful do/don't comparisons with executable Swift code.

Suggestions

Trim the MUST DO/MUST NOT DO constraints to only non-obvious, Swift-specific guidance — remove items like 'Skip error handling' and 'Use type hints' that Claude already knows.

Provide the referenced bundle files (e.g., `references/swiftui-patterns.md`) or remove the reference table if they don't exist, as broken references reduce trust in the skill.

DimensionReasoningScore

Conciseness

The skill is reasonably efficient but includes some unnecessary content. The 'MUST DO' constraints list items Claude already knows (e.g., 'Use type hints and inference appropriately', 'Skip error handling'), and the anti-patterns in code examples add bulk. The ❌ DON'T examples are useful but could be more concise with inline comments rather than full implementations.

2 / 3

Actionability

The skill provides fully executable, copy-paste-ready Swift code examples across multiple domains (async/await, SwiftUI, protocols, actors). Each pattern shows both correct and incorrect approaches with concrete, compilable code rather than pseudocode.

3 / 3

Workflow Clarity

The core workflow is clearly sequenced with explicit validation checkpoints after steps 3, 4, and 5, including specific commands (`swift build`, `swift build -warnings-as-errors`, `swift test`). The validation block explicitly calls out what to check at each stage, including a feedback mechanism for actor isolation warnings.

3 / 3

Progressive Disclosure

The reference table with 'Load When' guidance is well-structured and clearly signals when to consult each reference file. However, no bundle files were provided, meaning all five referenced files (e.g., `references/swiftui-patterns.md`) are missing, so the progressive disclosure structure is aspirational rather than functional. The inline content is also fairly long, with some material (like the full constraints list) that could be offloaded.

2 / 3

Total

10

/

12

Passed

Description

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 articulates specific capabilities, provides comprehensive trigger terms covering the Swift/Apple ecosystem, and explicitly states both what the skill does and when to invoke it. The description is well-structured with a natural separation between capabilities and trigger conditions, and it covers a broad but distinct domain with minimal conflict risk.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: builds iOS/macOS/watchOS/tvOS applications, implements SwiftUI views and state management, designs protocol-oriented architectures, handles async/await concurrency, implements actors for thread safety, and debugs Swift-specific issues.

3 / 3

Completeness

Clearly answers both 'what' (builds apps, implements SwiftUI views, designs architectures, handles concurrency, debugs issues) and 'when' with explicit trigger guidance ('Use when building iOS/macOS applications with Swift 5.9+...' and 'Invoke for protocol-oriented programming, SwiftUI state management, actors...').

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: iOS, macOS, SwiftUI, Swift 5.9+, async/await, protocol-oriented programming, actors, UIKit, Combine, Vapor, server-side Swift, watchOS, tvOS. These are all terms developers would naturally use when seeking help with Swift development.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche in Swift/Apple platform development. The specific mentions of SwiftUI, actors, Vapor, UIKit, and Combine create a well-defined boundary that is unlikely to conflict with general programming or web development skills.

3 / 3

Total

12

/

12

Passed

Validation

90%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

Total

10

/

11

Passed

Repository
Jeffallan/claude-skills
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.