CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

swift-testing

Write, review, or migrate Swift unit tests using Swift Testing, while preserving XCTest/XCUITest where their APIs are still required. Use for test design, async behavior, traits, parameterization, migration boundaries, and version-gated testing APIs.

Quality

87%

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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-crafted, token-efficient instruction skill: directive guidance with exact API names, a decision table for framework choice, and clean separation into two substantive reference files. The only meaningful gaps are the absence of inline examples for common patterns and explicit feedback loops in the migration workflow, both of which are partially covered by the references and checklist.

DimensionReasoningScore

Conciseness

The body is lean and directive throughout (e.g., "Use #expect for independent checks and try #require when later assertions depend on an unwrapped or validated value") with no padding and no explanation of basics Claude already knows. Every line carries Swift Testing-specific guidance such as "Tests run in parallel by default; isolate mutable fixtures instead of depending on declaration order".

5 / 5

Actionability

Concrete, executable guidance throughout: exact API names, a framework-choice decision table, and precise migration mappings ("XCTUnwrap maps to try #require", "fulfillment-based async tests may map to confirmation"). Not 5 because some mappings are hedged ("usually maps") and common patterns like confirmation usage have no inline example, deferring entirely to references.

4 / 5

Workflow Clarity

A coherent preflight-to-review flow: "Inspect the Xcode/Swift toolchain, target platform, test target type... before recommending APIs", then framework choice, patterns, migration, and a closing review checklist, plus a verification step ("Verify versioned test APIs against Swift Evolution, release notes, SDK interfaces"). Not 5 because there are no explicit error-recovery/feedback loops and validation rests mostly on the end-of-body checklist.

4 / 5

Progressive Disclosure

A concise ~95-line overview with a contents TOC, split appropriately into two real one-level-deep reference files that exist in the bundle and are clearly signaled with what they contain ("Read [Testing Patterns](references/testing-patterns.md) for suite organization, traits, confirmation, mocks, parameterization, execution behavior, and migration examples"). No nested references; navigation is easy.

5 / 5

Total

18

/

20

Passed

Description

83%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 that states concrete actions, an explicit Use-for trigger clause, and a distinctive framework niche. The main improvement opportunities are adding commonly-cited API names like @Test/#expect as triggers and tightening the async-behavior trigger to "async test behavior" to avoid overlap with concurrency skills.

DimensionReasoningScore

Specificity

"Write, review, or migrate Swift unit tests using Swift Testing, while preserving XCTest/XCUITest" lists several specific concrete actions with a clear domain. It is not 5 because capabilities the skill covers (attachments, exit tests, suite organization) are absent from the description, leaving minor gaps in coverage.

4 / 5

Completeness

Explicitly answers both "what" (write, review, or migrate Swift unit tests; preserve XCTest/XCUITest where required) and "when" via a concrete "Use for test design, async behavior, traits, parameterization, migration boundaries, and version-gated testing APIs" clause. Not 4 because the when-clause is explicit and specific rather than vague.

5 / 5

Trigger Term Quality

Strong natural keyword coverage including framework names users would say: "Swift Testing", "XCTest", "XCUITest", "unit tests", "parameterization", "migration". A few natural terms are missing, such as the macro names (@Test, #expect) users commonly cite when asking about Swift Testing.

4 / 5

Distinctiveness Conflict Risk

Clear Swift-testing niche with distinct framework-name triggers and low conflict risk with unrelated skills. Not 5 because "async behavior" as a trigger term invites overlap with a dedicated Swift concurrency skill.

4 / 5

Total

17

/

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

thienqo/ios-skills

Path

skills/swift-testing/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.