CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

apple-app-development

This skill should be used when the user asks to "create a SwiftUI view", "build an iOS app", "set up an Xcode project", "review Apple platform code", "add a widget", "create a watchOS app", "build for visionOS", "fix SwiftUI layout", or when generating any Swift code targeting Apple platforms (iOS, iPadOS, macOS, tvOS, watchOS, visionOS). Provides modern SwiftUI-first best practices covering UI patterns, app lifecycle, navigation, project structure, and platform-specific guidance. Covers Apple platform frameworks and app structure, not the language itself — for Swift language fundamentals use `swift-development` alongside it. Always generates Swift unless the project explicitly requires Objective-C.

85

1.05x
Quality

91%

Does it follow best practices?

Impact

100%

1.05x

2 of 3 eval scenarios. Add 1 more for a full score.

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-built reference skill: executable examples, concrete rules, correct progressive disclosure with all referenced files present and real. The body is mostly lean for the breadth covered; its only real flaws are minor duplication between the SwiftUI Essentials and Apple Concurrency Patterns sections.

Suggestions

Remove the duplicated guidance: the SettingsViewModel example in Apple Concurrency Patterns repeats the UserViewModel pattern from SwiftUI Essentials, and the '.task cancels automatically' rule appears in both sections plus the mistakes table — keep one canonical statement and cross-reference it.

Consider consolidating the scattered decision rules (greenfield vs. legacy, check deployment target, respect existing architecture) into one short ordered checklist at the top so the application sequence is explicit.

DimensionReasoningScore

Conciseness

The body is dense, rule-driven, and assumes Claude's competence — no padding or explanations of basic concepts. Minor trimming opportunities keep it below the lean anchor: the `.task`-cancels rule appears twice (SwiftUI Essentials and Apple Concurrency Patterns) and again in the mistakes table, and the short `@MainActor @Observable` ViewModel example in Apple Concurrency Patterns substantially repeats the UserViewModel example in SwiftUI Essentials.

4 / 5

Actionability

Fully executable, copy-paste-ready Swift for the common cases: design tokens and theming, `@Observable` ViewModel + View, the complete MVVM pattern including dependency injection, and a realistic TCA alternative. Concrete rules ("never raw values", "body exceeds ~30 lines", "suffix `View`") and a mistakes table with specific fixes round it out.

5 / 5

Workflow Clarity

Decision guidance is clear and ordered — check project context first (deployment target, Swift version, existing architecture), then greenfield vs. legacy rules ("existing UIKit screens should not be partially rewritten"), then per-platform reference routing via tables. It stays at 4 rather than 5 because the application flow is distributed across rule bullets rather than given as an explicit ordered sequence with checkpoints, and the duplicated `.task` guidance slightly muddies the rules.

4 / 5

Progressive Disclosure

Exemplary structure: SKILL.md is a true overview, all 20 referenced files exist on disk with substantial content (verified), each is one level deep with a one-line scope summary, and the platform/cross-platform tables plus inline pointers (e.g., "See `references/localization.md` for String Catalog patterns") make navigation easy.

5 / 5

Total

18

/

20

Passed

Description

95%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: explicit 'use when' triggers phrased as natural user requests, a clear statement of what the skill covers, and explicit boundary disambiguation against the sibling Swift-language skill. The only weakness is that the 'what' portion enumerates covered topics rather than concrete actions.

DimensionReasoningScore

Specificity

The description names concrete coverage areas ("UI patterns, app lifecycle, navigation, project structure, and platform-specific guidance") and pairs them with concrete user actions ("create a SwiftUI view", "set up an Xcode project", "add a widget"). It sits between the 4 and 5 anchors: the 'what' leans toward listing covered topics rather than enumerating concrete actions, keeping it just below the comprehensive-action anchor.

4 / 5

Completeness

Both 'what' ("Provides modern SwiftUI-first best practices covering UI patterns, app lifecycle, navigation, project structure, and platform-specific guidance") and 'when' ("This skill should be used when the user asks to...") are explicit and concrete, with concrete trigger phrases — matching the top anchor. It also adds a boundary clause for Swift language fundamentals.

5 / 5

Trigger Term Quality

Natural trigger phrases users would actually say are comprehensively covered: "create a SwiftUI view", "build an iOS app", "set up an Xcode project", "review Apple platform code", "add a widget", "create a watchOS app", "build for visionOS", "fix SwiftUI layout", plus the full platform enumeration (iOS, iPadOS, macOS, tvOS, watchOS, visionOS) and the catch-all "generating any Swift code targeting Apple platforms". This matches the comprehensive synonym/variation anchor.

5 / 5

Distinctiveness Conflict Risk

Clear niche (Apple platform app development) with distinct triggers, and the main overlap risk — the sibling `swift-development` skill — is explicitly resolved: "not the language itself — for Swift language fundamentals use `swift-development` alongside it". Third-person voice is used throughout, so no voice penalty applies.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

provectus/awos-recruitment

Path

registry/skills/apple-app-development/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.