CtrlK
BlogDocsLog inGet started
Tessl Logo

hig-components-search

Apple HIG guidance for navigation-related components including search fields, page controls, and path controls.

51

Quality

56%

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/skills/hig-components-search/SKILL.md

The canonical home for this skill is hig-components-search in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

67%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured design guidance skill that efficiently communicates navigation component principles and provides clear references to detailed materials. Its main weakness is the lack of concrete, actionable implementation examples—it reads more as a decision-making framework than a hands-on implementation guide. The progressive disclosure and organization are solid, with appropriate use of reference files.

Suggestions

Add concrete code examples (SwiftUI/UIKit) for at least one component (e.g., a search field with scope buttons) to improve actionability

Remove the 'When to Use' section at the bottom which adds no meaningful information

Include a brief example scenario showing the full output format in action (component recommendation → behavior spec → platform differences) to make the workflow more concrete

DimensionReasoningScore

Conciseness

The content is fairly efficient, presenting principles as concise numbered points without over-explaining concepts Claude already knows. Minor verbosity in the 'Questions to Ask' and 'Related Skills' sections that could be trimmed, and the 'When to Use' section at the bottom adds no value.

4 / 5

Actionability

The skill provides design guidance principles and an output format structure, but lacks concrete executable examples—no code snippets, no specific SwiftUI/UIKit implementations, no copy-paste ready component configurations. It's more of a decision framework than actionable implementation guidance.

3 / 5

Workflow Clarity

The output format section provides a clear 3-step sequence for recommendations, and the questions to ask provide a discovery workflow. However, there's no explicit validation or feedback loop for verifying the recommendation is correct. Since this is a non-destructive advisory skill, the lack of validation steps is less critical.

4 / 5

Progressive Disclosure

Good structure with a reference index table pointing to three separate reference files, related skills clearly listed, and the main content kept as a concise overview. Minor gap: no bundle files were provided to verify the referenced paths exist, and the related skills section could be more clearly signaled as cross-references rather than inline content.

4 / 5

Total

15

/

20

Passed

Description

45%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 identifies a clear domain (Apple HIG navigation components) and lists specific component types, giving it reasonable distinctiveness. However, it lacks concrete actions describing what the skill actually does and entirely omits a 'Use when...' clause, making it harder for Claude to know when to select this skill. Adding trigger guidance and more natural user-facing keywords would significantly improve selection accuracy.

Suggestions

Add a 'Use when...' clause with trigger phrases like 'Use when the user asks about Apple HIG navigation patterns, search bars, page indicators, breadcrumbs, or iOS/macOS navigation design.'

Describe concrete actions the skill performs, e.g., 'Provides design recommendations, layout specifications, and usage guidelines for navigation-related components per Apple Human Interface Guidelines.'

Include natural synonyms and related terms users might say, such as 'Human Interface Guidelines', 'iOS', 'macOS', 'navigation bar', 'breadcrumb', 'search bar', 'UI navigation'.

DimensionReasoningScore

Specificity

Names the domain (Apple HIG guidance) and lists specific components (search fields, page controls, path controls), but doesn't describe concrete actions like 'provides layout recommendations' or 'generates compliant code'. It tells you what it covers but not what it does with that coverage.

3 / 5

Completeness

Provides a partial 'what' (HIG guidance for navigation components) but has no 'when' clause at all. There is no 'Use when...' or equivalent trigger guidance, which per the rubric should cap completeness at 3, and the 'what' itself is only moderately clear.

2 / 5

Trigger Term Quality

Includes some relevant keywords like 'Apple HIG', 'search fields', 'page controls', and 'path controls', but misses natural user phrases like 'navigation bar', 'iOS navigation', 'macOS', 'Human Interface Guidelines', 'UI design', or 'Apple design guidelines'.

3 / 5

Distinctiveness Conflict Risk

Fairly distinct by specifying Apple HIG and navigation-related components specifically, which narrows the scope. However, it could overlap with other Apple HIG skills covering different component categories or general UI design skills.

4 / 5

Total

12

/

20

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.