CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

swiftui-pro

Comprehensively reviews SwiftUI code for best practices on modern APIs, maintainability, and performance. Use when reading, writing, or reviewing SwiftUI projects.

63

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./swiftui-pro/skills/swiftui-pro/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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.

The body is a well-structured orchestration document: a clear 11-step review workflow, sensible gating of partial and deep reviews, and a concrete output format with a worked example. Its weaknesses are duplicated reference listings and inline version-specific facts, and — most materially — every cited reference file is absent from the bundle, so the progressive-disclosure structure exists only on paper.

Suggestions

Deduplicate the reference list: the numbered process steps already cite each of the 12 files, so the trailing '## References' section repeats them all — keep one listing (preferably the annotated one) and drop the other.

Move time-sensitive version facts (iOS 27, Xcode 27.1, Swift 6.4, iPhone Duo) out of inline Core Instructions into the references/api.md (or a dedicated versions section) so the main body stays stable as versions change.

Ship the referenced files: the bundle contains no references/ directory, so all 12 cited paths (api.md, views.md, data.md, navigation.md, design.md, resizability.md, accessibility.md, localization.md, performance.md, performance-plus.md, swift.md, hygiene.md) are broken and the review process cannot actually be executed as written.

DimensionReasoningScore

Conciseness

The body is mostly efficient — directive, no explanation of concepts Claude already knows — but it can be tightened: the '## References' section re-lists all 12 file paths already cited inline in the numbered process, and time-sensitive version facts ('iOS 27 exists, and is the default deployment target', 'Xcode 27.1', 'Target Swift 6.4') sit in Core Instructions rather than a versioned or deprecated-patterns section, which the judging guidelines penalize for conciseness. It is above the verbose anchor (2) because there is no concept over-explanation or padding beyond the reference duplication and version sprawl.

3 / 5

Actionability

The numbered process assigns a concrete check with an explicit file path to each concern, and the Output Format specifies an exact contract (file, line, named rule, before/after code) demonstrated by a fully worked, executable example. It is not a 5 because the substantive review rules are delegated to reference files, so the body alone provides the orchestration and output contract rather than the concrete review content itself.

4 / 5

Workflow Clarity

The 11-step sequence is clearly ordered, each step names its reference file, and partial-review and deep-performance gating rules ('load only the relevant reference files', keep 'performance-plus.md' out of routine reviews) add real routing logic. This is a read-only review skill, so the destructive/batch validation cap does not apply; it stays at 4 rather than 5 because verification checkpoints are implicit ('Report only genuine problems – do not nitpick') rather than explicit validate-then-report steps.

4 / 5

Progressive Disclosure

As written, the design is exemplary — one-level-deep references, each with a descriptive blurb, plus deliberate gating of the deeper performance-plus.md — which would match the top anchor. But scored against the actual bundle, no references/ directory exists, so all 12 cited '${CLAUDE_SKILL_DIR}/references/*.md' files are missing and none of the paths can actually be navigated; the split is nominal rather than real, which drops it to the mid anchor rather than rewarding structure that cannot be followed.

3 / 5

Total

14

/

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 explicitly covers what the skill does and when to use it, in third person, with a clear SwiftUI niche and concrete trigger phrasing. The only gaps are missing synonym terms like 'Swift', 'iOS', or '.swift' and the mild padding of 'Comprehensively'.

DimensionReasoningScore

Specificity

The description names the domain and a concrete action with three concrete review dimensions — 'reviews SwiftUI code for best practices on modern APIs, maintainability, and performance' — which sits above the 1-2-action anchor but is a single action verb rather than a list of several distinct actions, so it does not fully reach the 5 anchor. The word 'Comprehensively' is minor fluff, and third-person voice is used correctly.

4 / 5

Completeness

Both halves are explicit: the 'what' is 'reviews SwiftUI code for best practices on modern APIs, maintainability, and performance' and the 'when' is the concrete trigger phrase 'Use when reading, writing, or reviewing SwiftUI projects', matching the top anchor exactly. Not below 5 because neither half is vague or only implied.

5 / 5

Trigger Term Quality

'SwiftUI' appears twice ('SwiftUI code', 'SwiftUI projects') alongside natural activity phrasings ('reading, writing, or reviewing'), matching the good-coverage-with-a-few-missing anchor. It is not a 5 because common synonyms users would naturally say — 'Swift', 'iOS', or '.swift' files — are absent.

4 / 5

Distinctiveness Conflict Risk

'SwiftUI' is a clear niche with tight, distinct triggers — the description only claims SwiftUI scope, so it would not fire for generic document, data, or non-SwiftUI language work. Overlap risk with adjacent skills (e.g., a general Swift style skill) is minimal and not enough to drop to 4.

5 / 5

Total

18

/

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

twostraws/SwiftUI-Agent-Skill

Path

swiftui-pro/skills/swiftui-pro/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.