CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

focus-engine

Implements keyboard, directional, and scene-level focus behavior across SwiftUI and UIKit. Use when managing @FocusState, defaultFocus, focused values, focusable interactions, focus sections, tvOS geometric focus and Siri Remote navigation, watchOS Digital Crown input, visionOS connected-device focus versus gaze hover/input targets, macOS key view loop and Full Keyboard Access, focus restoration after presentation changes, custom focus routing with UIFocusGuide, or debugging focus with UIFocusDebugger.

Quality

95%

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

The canonical home for this skill is dpearson2699/swift-ios-skills

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 pattern reference with fully executable examples, clear when-to-use and escalation guidance, and clean progressive disclosure into three real, one-level-deep reference files. The only notable weakness is redundancy between the Common Mistakes, Review Checklist, and intro boundary guidance.

Suggestions

Deduplicate Common Mistakes against the Review Checklist — several items (decorative focusable views, focus restoration, visionOS gaze) appear in both; consider merging mistakes 1–8 pointers into the checklist or vice versa.

Trim the intro boundary bullets (lines 10–13), which restate checklist items 9–10, to a single sentence pointing at the ios-accessibility handoff.

DimensionReasoningScore

Conciseness

The body is efficient — terse when-to-use guidance plus complete code per pattern, with no padding explaining concepts Claude already knows. However, the Common Mistakes list duplicates several Review Checklist items (e.g., mistakes 4/5 mirror checklist lines), and the intro boundary bullets restate checklist items 9–10, so minor trimming is possible. This lands on anchor 4 ('minor instances that could be trimmed') rather than anchor 5's 'every token earns its place'.

4 / 5

Actionability

Every section ships complete, copy-paste-ready, executable Swift: the LoginView @FocusState/onSubmit flow, .defaultFocus sidebar, focusedSceneValue recipe binding, .focusable(interactions: .activate) card, focusSection() layout, sheet-dismiss focus restoration, and a fully constrained UIFocusGuide. Specific examples cover the common cases, matching anchor 5.

5 / 5

Workflow Clarity

As a single-purpose pattern skill it needs no multi-step pipeline, and its guidance is unambiguous: each pattern states when to use it ("Use focus sections … when default left/right or up/down movement skips the intended group"), mistake 6 gives an explicit escalation order (layout grouping → focusSection() → UIFocusGuide), and the Review Checklist acts as a validation checkpoint. Under the simple-skill exception this earns 5; there are no destructive or batch operations requiring additional feedback loops.

5 / 5

Progressive Disclosure

The body is a clear overview: core SwiftUI/UIKit patterns inline, with three well-labeled one-level-deep references (focus-patterns.md, multi-platform-focus.md, focus-debugging.md), all verified to exist with no nested references. A Contents TOC aids navigation, and platform-specific detail is appropriately split into the references, matching anchor 5.

5 / 5

Total

19

/

20

Passed

Description

96%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 with an explicit what-plus-when structure, comprehensive concrete capability enumeration, and natural platform-specific trigger terms. The only weakness is minor overlap risk from broadly-scoped input terms (Digital Crown, keyboard) that could trigger it for adjacent interaction topics.

Suggestions

Narrow "watchOS Digital Crown input" to something like "watchOS Digital Crown focus" so the description does not trigger on general crown scroll/input questions.

Consider adding "focus engine" and "first responder" as trigger synonyms to better match how users phrase tvOS and macOS focus questions.

DimensionReasoningScore

Specificity

The description enumerates many concrete, API-named capabilities — "managing @FocusState, defaultFocus, focused values, focusable interactions, focus sections", "custom focus routing with UIFocusGuide", "debugging focus with UIFocusDebugger" — with comprehensive platform coverage (tvOS, watchOS, visionOS, macOS). This matches the anchor for multiple specific concrete actions with comprehensive coverage; the gaps are too minor for anchor 4.

5 / 5

Completeness

It explicitly answers both: what ("Implements keyboard, directional, and scene-level focus behavior across SwiftUI and UIKit") and when ("Use when managing @FocusState, defaultFocus, … or debugging focus with UIFocusDebugger") with concrete trigger phrases. This is the anchor-5 pattern; anchor 4 would require a weaker or less specific 'when' clause.

5 / 5

Trigger Term Quality

Natural trigger terms users would actually say are covered comprehensively with synonyms: "@FocusState", "keyboard", "Siri Remote", "Digital Crown", "gaze hover", "Full Keyboard Access", "key view loop", "focus restoration". Only marginal terms like "focus engine" or "first responder" are missing, which keeps it at anchor 5 rather than signaling anchor 4's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

The focus niche is clear and API-specific triggers are unlikely to fire for the wrong skill, but "watchOS Digital Crown input" and generic "keyboard" phrasing could pull in crown-scroll or text-input requests, and the domain sits directly adjacent to the ios-accessibility skill (the body must explicitly draw that boundary). Mostly distinct with minor overlap risk matches anchor 4; it does not reach anchor 5's 'minimal conflict risk'.

4 / 5

Total

19

/

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

dpearson2699/swift-ios-skills

Path

skills/focus-engine/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.