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.

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

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

Quality

Content

65%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 content is well-structured and actionable with a clear decision tree and checklist, but its progressive disclosure collapses because it depends on 13 reference files that do not exist in the bundle. There is also notable redundancy between the guidelines, quick reference, and checklist sections.

Suggestions

Ship the references/ directory with all 13 referenced .md files, or remove the 'see references/...' pointers and inline the essential material so the skill is self-contained.

Collapse the duplication between Core Guidelines, Quick Reference, and Review Checklist into a single source of truth to cut tokens without losing coverage.

Verify each referenced path resolves before relying on it; the body states 'First, consult references/latest-apis.md' for every workflow yet that file is absent.

Dimension	Reasoning	Score
Conciseness	The body is mostly lean bullet-point guidance that assumes SwiftUI competence, but the guidelines, quick reference, and review checklist substantially overlap, repeating the same rules (e.g. @State private, ForEach identity) across multiple sections.	4 / 5
Actionability	Concrete, specific rules (e.g. 'Use .animation(_:value:) with value parameter', '@ScaledMetric for custom numeric values') and an executable Liquid Glass code example cover common cases, though most sections are directives rather than copy-paste runnable code.	4 / 5
Workflow Clarity	The three-branch decision tree (review/implement) gives a clear sequenced workflow with 'First, consult references/latest-apis.md' checkpoints, and the review checklist provides explicit verification items; minor validation gaps keep it just below 5.	4 / 5
Progressive Disclosure	The body repeatedly references 13 references/*.md files as if they exist ('First, consult references/latest-apis.md', 'see references/state-management.md'), but no references/ directory or any bundle files are present in the skill, so every reference is a dead link to material the agent cannot load.	1 / 5
	Total	13 / 20 Passed

Description

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

The description is concise, concrete, and complete — it states specific capabilities and explicit 'Use when' triggers tied to a clearly distinct SwiftUI niche. Minor gains would come from adding a few more natural synonyms, but it is already strong.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Write, review, or improve SwiftUI code' — across state management, view composition, performance, and Liquid Glass adoption, giving comprehensive coverage of the skill's capabilities.	5 / 5
Completeness	Explicitly answers both 'what' ('Write, review, or improve SwiftUI code...') and 'when' ('Use when building new SwiftUI features, refactoring existing views, reviewing code quality, or adopting modern SwiftUI patterns').	5 / 5
Trigger Term Quality	Natural phrases like 'building new SwiftUI features', 'refactoring existing views', 'reviewing code quality' match what users say, but it leans on technical phrasing and omits common synonyms or file/extension terms.	4 / 5
Distinctiveness Conflict Risk	The SwiftUI-specific niche, reinforced by iOS 26+ Liquid Glass triggers, is clearly distinguishable from other skills with minimal conflict risk.	5 / 5
	Total	19 / 20 Passed

Validation

87%

Warnings & errors only

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

Criteria	Description	Result
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
Commit: 57c135b

Reviewed: 7 days ago

Table of Contents

Discovery Implementation Validation

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.