CtrlK
BlogDocsLog inGet started
Tessl Logo

macos-swiftui-patterns

Build macOS SwiftUI scenes and components with desktop patterns. Use when shaping windows, commands, toolbars, settings, split views, or inspectors.

64

Quality

76%

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 ./.agents/skills/macos-swiftui-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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-structured, expert-level overview with genuine progressive disclosure — every reference path is real, one level deep, and clearly scoped — and unusually concrete guidance (exact APIs, commands, file layout, decision table). The main cost is token efficiency: several rules are stated two to five times across Quick Start, General Rules, and Anti-Patterns, and the body could be trimmed meaningfully without losing information.

Suggestions

State each rule once: consolidate the sidebar-row/custom-background guidance (repeated across General Rules lines 65-70 and three anti-pattern bullets) and the 30-char MenuBarExtra cap (lines 63 and 110) into single canonical statements.

Merge the 'Pre-Edit Checklist' into the 'Workflow For A New macOS Scene Or View' as its early steps, since the two sequences currently overlap and compete.

Trim the duplicated no-hardcoded-white rule (lines 28, 65, and 112) to one General Rules entry plus one anti-pattern reference.

DimensionReasoningScore

Conciseness

The body contains almost no filler — every line is non-obvious expert guidance (e.g. the `WindowGroup(..., id:)` vs `Window(...)` launch distinction, the 30-char menu item cap) — but the same rules are restated repeatedly: sidebar/custom-background guidance appears in General Rules twice (lines 65-66 and 70) and again as three separate anti-patterns, the 30-char MenuBarExtra rule appears at lines 63 and 110, the Window/WindowGroup rule at lines 22 and 109, and the no-hardcoded-white rule at lines 28, 65, and 112. That is 'mostly efficient but could be tightened' (3) rather than noticeably padded (2) because the duplicated material is dense guidance, not explanation of concepts Claude already knows.

3 / 5

Actionability

Guidance is highly concrete and executable: exact shell commands (`git rev-parse --is-inside-work-tree`), exact API calls (`NSApp.setActivationPolicy(.regular)`, `@SceneStorage`, `@AppStorage`), a prescriptive file tree (`App/`, `Views/`, `Models/`, `Stores/`, `Services/`, `Support/`), a precise 50-line single-file threshold, and a lookup table mapping state scenarios to specific wrappers. It falls short of fully copy-paste-ready (5) because it defers to external skills not in the bundle ('use the exact bootstrap contract from the `macos-build-run-debug` skill') and offers no inline code snippet, relying on the reference files for examples.

4 / 5

Workflow Clarity

There is a clear 7-step 'Workflow For A New macOS Scene Or View' that ends with explicit validation ('Validate the flow with a build and a quick usability pass: multiwindow assumptions, settings entry points, and selection stability'), plus a Pre-Edit Checklist that front-loads sequencing. This is 'clear sequence with most checkpoints present' (4) rather than 5 because there is no error-recovery loop around the build step (what to do when the build fails) and the two quick-start tracks are partially overlapping with the workflow and checklist rather than one canonical sequence.

4 / 5

Progressive Disclosure

The body is a true overview: all six referenced files exist in the bundle, each is listed in 'Cross-Cutting References' with a one-line scope description, navigation is one level deep, and a designated entry point (`references/components-index.md`) is named both in Quick Start and in a dedicated section. Detail (code examples, per-component guidance) is pushed into the reference files, and the inline material (rules, table, anti-patterns) is appropriately overview-level, matching the top anchor.

5 / 5

Total

16

/

20

Passed

Description

82%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 concise, third-person description with an explicit and well-populated 'Use when' clause covering six natural desktop trigger terms. Its only weakness is that the 'what' half relies on one generic verb ('Build') rather than enumerating the concrete capabilities the body actually provides.

Suggestions

Replace the generic 'Build ... with desktop patterns' with 2-3 concrete actions, e.g. 'Scaffold macOS SwiftUI scenes and windows, wire commands and toolbars, and structure settings, split views, and inspectors with desktop patterns.'

Add one or two natural synonyms users say that are currently missing, such as 'menus', 'menu bar', or 'sidebars', to broaden trigger coverage without adding length.

DimensionReasoningScore

Specificity

The description names the domain ('macOS SwiftUI scenes and components') but rests on a single generic action verb — 'Build ... with desktop patterns' — rather than listing several concrete capabilities, matching the 'names domain and 1-2 concrete actions, but not comprehensive' anchor. It is not score 4 because no additional specific actions (e.g., wire commands, scaffold settings scenes, structure split views) are enumerated.

3 / 5

Completeness

It explicitly answers both parts: 'what' — 'Build macOS SwiftUI scenes and components with desktop patterns' — and 'when' — an explicit 'Use when' clause with six concrete trigger phrases. This matches the top anchor for a clear what AND when with concrete trigger phrases; nothing is merely implied.

5 / 5

Trigger Term Quality

'Use when shaping windows, commands, toolbars, settings, split views, or inspectors' supplies six natural trigger terms a user would plausibly say, plus 'macOS' and 'SwiftUI'. It falls short of the comprehensive anchor (5) because common synonyms users say are absent — e.g. 'menu bar', 'sidebar', 'menus', 'keyboard shortcuts', 'app scaffold'.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — macOS desktop SwiftUI patterns — and every trigger term (windows, toolbars, settings, split views, inspectors) is desktop-specific, minimizing overlap with generic SwiftUI, iOS, or AppKit-focused skills. It sits above the 'minor overlap risk' (4) anchor because the desktop-only trigger vocabulary leaves little ambiguity.

5 / 5

Total

17

/

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
robinebers/openusage
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.