CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

swiftui-expert-skill

Write, review, or improve SwiftUI code following best practices for state management, view composition, performance, and iOS 26+ Liquid Glass adoption. Use when building new SwiftUI features, refactoring existing views, reviewing code quality, or adopting modern SwiftUI patterns.

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 ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/swiftui-expert-skill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 well-structured and highly actionable, with a clear three-workflow decision tree, concrete SwiftUI rules, and a well-signaled reference system. The main issues are near-verbatim duplication between Core Guidelines and the Review Checklist, and the fact that every workflow depends on reference files that are absent from the bundle, which undermines both navigation and the 'First, consult references/latest-apis.md' steps.

Suggestions

Merge the Review Checklist into the Core Guidelines sections (or convert Core Guidelines into the checklist) to remove the ~70 lines of duplicated content.

Ship the 14 referenced files (especially the 'Required reading' references/latest-apis.md) or remove/condense the citations, since every workflow currently depends on files not present in the bundle.

Add a short feedback loop to the review workflow, e.g., 'after applying fixes, re-run the Review Checklist to confirm no regressions'.

DimensionReasoningScore

Conciseness

The body is dense, rule-style writing without padded prose, but the ~70-line Review Checklist section restates the Core Guidelines bullets nearly verbatim (e.g., '@State properties are private', 'ForEach uses stable identity'), which is significant duplication that could be tightened. This fits anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') better than anchor 4, where trimming would be minor rather than removing an entire redundant section.

3 / 5

Actionability

Concrete, specific guidance throughout: exact property-wrapper rules, named modifiers ('.animation(_:value:)', 'glassEffectID' with '@Namespace'), a debug command ('Self._printChanges()'), and one copy-paste-ready Liquid Glass code block with an #available fallback. Not anchor 5 because common state-management and animation patterns lack inline code examples (they are delegated to reference files), leaving minor gaps in executable coverage.

4 / 5

Workflow Clarity

The three workflows (review/improve/implement) are clearly sequenced by user intent, each with an ordered checklist of steps and a final Review Checklist section acting as validation checkpoints, plus '#available' fallback handling. It falls short of anchor 5 because there is no explicit feedback loop (e.g., 'after fixes, re-run the checklist') and no guidance on prioritizing which issues to fix first.

4 / 5

Progressive Disclosure

Excellent structure: an overview, a decision tree routing to one-level-deep references that are clearly signaled inline and cataloged in a dedicated References section with per-file descriptions. However, the 14 cited 'references/*.md' files are not present in the bundle (no references/ directory exists), so the navigation as shipped is broken and cannot be verified, keeping this below anchor 5.

4 / 5

Total

15

/

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 clearly states what the skill does and when to use it, with concrete natural-language triggers aligned to its three workflows. The main weaknesses are slightly generic phrasing ('following best practices'), a few missing natural synonyms, and one overly broad trigger ('reviewing code quality') that could overlap with a general code-review skill.

Suggestions

Replace the generic 'reviewing code quality' trigger with something more scoped, e.g., 'reviewing or auditing SwiftUI code'.

Add one or two natural synonyms users would say, such as 'Swift', 'SwiftUI views', or 'iOS app UI'.

Mention a covered capability like accessibility or navigation to close the minor coverage gap.

DimensionReasoningScore

Specificity

Names concrete actions ('Write, review, or improve SwiftUI code') and four named focus areas ('state management, view composition, performance, and iOS 26+ Liquid Glass adoption'), comparable to the anchor-4 example of several specific actions with minor gaps. It falls short of a 5 because 'following best practices' is slightly generic and covered sub-topics like accessibility and navigation are absent, while it is clearly above anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

Explicitly answers both what ('Write, review, or improve SwiftUI code following best practices for state management, view composition, performance, and iOS 26+ Liquid Glass adoption') and when ('Use when building new SwiftUI features, refactoring existing views, reviewing code quality, or adopting modern SwiftUI patterns') with concrete trigger phrases, matching the anchor-5 example pattern. Not anchor 4 because the when-clause is fully explicit with multiple concrete triggers, not merely adequate.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'building new SwiftUI features', 'refactoring existing views', 'reviewing code quality', 'adopting modern SwiftUI patterns', plus 'SwiftUI', 'state management', 'performance', 'Liquid Glass'. A few natural terms are missing (e.g., 'Swift', 'SwiftUI views', 'iOS app UI'), so it fits anchor 4 rather than anchor 5's comprehensive synonym coverage, but it is well above anchor 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

The SwiftUI/Liquid-Glass niche is clear and mostly distinct, but the trigger 'reviewing code quality' is broad and creates minor overlap risk with general code-review skills, matching anchor 4. Not anchor 5 because that generic review trigger could fire outside SwiftUI; not anchor 3 because the domain is tightly scoped to SwiftUI and unlikely to collide with unrelated skills.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 52 missing

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/swiftui-expert-skill/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.