CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

swift-api-design-guidelines

Apply Swift API Design Guidelines to names, argument labels, mutating/nonmutating pairs, protocols, and documentation comments. Use when designing or reviewing Swift APIs for clarity at the call site; file and project organization belongs to the relevant architecture/UI skill.

Quality

89%

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.

Well-structured, token-efficient guideline content that provides concrete, directly applicable rules with specific Swift examples and cleanly pushes extended material into four real, one-level-deep reference files. The only weaknesses are minor: some redundancy between the rules, Common Mistakes, and Review Checklist sections, and the absence of an explicitly sequenced review workflow.

DimensionReasoningScore

Conciseness

Lean, rule-dense sections with no explanation of basic Swift concepts; every section instructs rather than describes. Not 5 because the Common Mistakes and Review Checklist sections partially restate the rule sections (e.g., Boolean assertion naming and type-repeating labels appear twice), which could be tightened.

4 / 5

Actionability

Concrete, immediately applicable guidance throughout: specific identifier examples ("sort()", "sorted()", "union(_:)" / "formUnion(_:)", "isEmpty", "remove(item)" vs "remove(element: item)"), a first-applicable-rule decision table for label strategy, and concrete bad examples in Common Mistakes. As an instruction-only skill whose specific examples cover the common cases, it meets the top anchor.

5 / 5

Workflow Clarity

A single-purpose guidelines/review skill with a clear decision procedure ("Use the first applicable rule") and a Review Checklist that serves as validation checkpoints. Not 5 because there is no explicitly ordered workflow for conducting a review pass (e.g., when to apply which section), and the skill exceeds the simple under-50-line exception.

4 / 5

Progressive Disclosure

The body is a concise overview with four one-level-deep references (all verified to exist in references/), each clearly signaled in its section with when-to-read guidance, plus a References index. Content is appropriately split: rules inline, extended examples and edge cases in the bundle files.

5 / 5

Total

18

/

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 that clearly and explicitly states both capability and trigger conditions in third-person voice, with concrete domain-specific terms and an explicit boundary clause that reduces conflict risk with neighboring skills. The only minor gap is that capabilities are expressed through one generalized verb rather than multiple distinct actions, and a few natural trigger synonyms are absent.

DimensionReasoningScore

Specificity

Lists five concrete capability areas ("names, argument labels, mutating/nonmutating pairs, protocols, and documentation comments") within the Swift API design domain. Not 5 because the action is a single generalized verb ("Apply") applied to targets, whereas the 5 anchor shows multiple distinct concrete actions.

4 / 5

Completeness

Explicitly answers both questions: what ("Apply Swift API Design Guidelines to names, argument labels, mutating/nonmutating pairs, protocols, and documentation comments") and when ("Use when designing or reviewing Swift APIs for clarity at the call site") with concrete trigger phrasing. Not 4 because the 'when' clause is explicit and specific rather than generic.

5 / 5

Trigger Term Quality

Natural phrases like "designing or reviewing Swift APIs" and "clarity at the call site" plus specific terms ("argument labels", "protocols", "documentation comments") give good coverage. A few natural variations users might say (e.g., "naming", "Swift naming conventions") are missing, so it falls short of the 5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Swift API design guidelines) with an explicit boundary statement ("file and project organization belongs to the relevant architecture/UI skill") that actively routes away overlapping requests. Minimal conflict risk with sibling skills.

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

thienqo/ios-skills

Path

skills/swift-api-design-guidelines/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.