CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

focus-engine

Implement or debug keyboard, directional, and scene-level focus across SwiftUI and UIKit. Use for FocusState, focus restoration and routing, tvOS remote navigation, watchOS crown focus, visionOS input focus, macOS key loops, UIFocusGuide, or UIFocusDebugger.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 high-quality pattern catalog: complete executable examples per topic, explicit use conditions and API-preference ordering, a review checklist, and a clean split of detail into three clearly labeled reference files. The only notable weakness is triple restatement of the same guidance across sections, Common Mistakes, and the checklist, which costs some token efficiency.

DimensionReasoningScore

Conciseness

Sections are lean, assume Claude's competence (no explanation of what SwiftUI or focus is), and add genuinely non-obvious API guidance ("UIFocusGuide is invisible and not a view"). However, key guidance is repeated three times across section advice, "Common Mistakes", and the "Review Checklist" (e.g. @FocusState locality appears in all three), which is minor over-explanation that could be trimmed — anchor 4 rather than 5's 'every token earns its place'.

4 / 5

Actionability

Every section provides complete, copy-paste-ready Swift covering the common case: @FocusState field chaining with onSubmit, .defaultFocus, FocusedValueKey/focusedSceneValue, .focusable(interactions:), focusSection() grouping, sheet-dismissal focus restoration, and a fully constrained UIFocusGuide layout. This matches anchor 5 (fully executable, common cases covered); the undefined Recipe/FilterEditor types are standard illustrative placeholders, not gaps.

5 / 5

Workflow Clarity

There is no multi-step process to sequence (and none is needed — no destructive or batch operations, so the validation cap does not apply), but each pattern states an unambiguous use condition plus explicit ordering guidance (semantic controls before .focusable, focusSection() before UIFocusGuide) and a review checklist for verification. This fits anchor 4; it is not 5 because the skill is a multi-topic catalog rather than the single-action case the simple-skill exception covers.

4 / 5

Progressive Disclosure

The body is a well-organized overview (Contents navigation, one focused example per topic) and the References section points to three real, one-level-deep files with descriptive labels — detailed patterns, multi-platform focus, and debugging — all verified to exist with no nested .md chains. This matches anchor 5 (clear overview, well-signaled one-level-deep references, easy navigation).

5 / 5

Total

18

/

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: it states concrete actions, covers SwiftUI and UIKit across five platforms, and provides an explicit "Use for" clause with eight specific API-level triggers. The main gaps are a few missing natural synonyms (first responder, focus ring) and minor overlap risk with the accessibility-focus skill on generic "focus" queries.

DimensionReasoningScore

Specificity

"Implement or debug keyboard, directional, and scene-level focus across SwiftUI and UIKit" names concrete actions and the "Use for" list enumerates specific focus topics (FocusState, tvOS remote navigation, macOS key loops, UIFocusGuide), but a few capabilities covered in the body (focusSection, defaultFocus) are absent from the description. This matches the anchor 'lists several specific actions; minor gaps in coverage' rather than 5, whose example shows a broader set of distinct concrete actions.

4 / 5

Completeness

The 'what' is explicit ("Implement or debug keyboard, directional, and scene-level focus across SwiftUI and UIKit") and the 'when' is an explicit "Use for" clause listing eight concrete trigger phrases, which satisfies the equivalent-trigger-guidance requirement. This clearly matches anchor 5 (both what and when with concrete trigger phrases) rather than 4, where the 'when' could be more specific — here it is highly specific.

5 / 5

Trigger Term Quality

The description includes natural terms a developer would actually say — "FocusState", "focus restoration and routing", "tvOS remote navigation", "watchOS crown focus", "UIFocusGuide", "UIFocusDebugger" — but misses common variations like "first responder", "focus ring", or "key view loop". Good keyword coverage with a few natural terms missing fits 4; it exceeds anchor 3 ('some relevant keywords but missing common variations') because the coverage is broad and API-specific.

4 / 5

Distinctiveness Conflict Risk

The niche is clear with distinctive API-level triggers, but generic "focus" requests could overlap with the closely related ios-accessibility skill (VoiceOver/accessibility focus), a boundary the body itself has to police explicitly. Minor overlap risk with a closely related skill fits anchor 4; it does not reach 5's 'minimal conflict risk' given that acknowledged adjacency.

4 / 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

thienqo/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.