CtrlK
BlogDocsLog inGet started
Tessl Logo

hig-components-menus

Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered.

44

Quality

45%

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

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

SKILL.md
Quality
Evals
Security

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 skill body is a well-organized overview of Apple HIG menu and button design rules with a clean one-level-deep reference index pointing to 11 real files, demonstrating strong progressive disclosure and good conciseness. It is weaker on actionability and workflow clarity because the guidance is design-advisory rather than executable, with no code, commands, or validation checkpoints.

DimensionReasoningScore

Conciseness

The body is mostly lean: short numbered principles, a compact reference table, and brief sections without padding or explanations of concepts Claude already knows; the only minor excess is the duplicated 'check for context' opener and the boilerplate footer, keeping it just below the fully-lean anchor (5).

4 / 5

Actionability

Guidance is concrete at a design-rule level (e.g. 'Toolbars for frequent actions', 'Pop-up buttons for mutually exclusive choices', 'Dock menus: short and focused') but there is no executable code, commands, or worked examples, so it sits at the 'some concrete guidance but incomplete' anchor rather than the mostly-executable one (4).

3 / 5

Workflow Clarity

The 'Output Format' and 'Questions to Ask' sections give a usable sequence (recommend component, define hierarchy, cover platforms, list shortcuts), but there are no validation checkpoints or feedback loops; the skill is non-destructive advisory work so the destructive-cap does not apply, and the absence of explicit checkpoints places it at anchor 3.

3 / 5

Progressive Disclosure

The body is a concise overview with a well-signaled, one-level-deep Reference Index linking to 11 real reference files (menus.md, buttons.md, toolbars.md, etc., all present in references/), with topic and key-content columns for easy navigation, matching the clear-overview-with-one-level-references anchor exactly.

5 / 5

Total

15

/

20

Passed

Description

25%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 a generic process reminder rather than a capability statement: it tells Claude to check for an existing context file and avoid redundant questions, but never says what the skill does or when to invoke it. It lacks both concrete actions and natural trigger terms, and it is not distinct from other skills.

Suggestions

Rewrite the description to state the skill's actual capability, e.g. 'Recommends Apple HIG menu and button patterns (menus, toolbars, pop-up/pull-down buttons, disclosure controls) and their cross-platform behavior.'

Add an explicit 'Use when...' trigger clause naming natural phrases users would say, such as 'Use when designing menus, buttons, toolbars, or command interfaces for Apple platforms (iOS, iPadOS, macOS, visionOS).'

Use third-person capability voice ('Recommends...', 'Advises...') and drop the internal process directive about checking for a context file from the description.

DimensionReasoningScore

Specificity

The description names no concrete menu/button actions and instead gives generic process instruction ('Check for .claude/apple-design-context.md before asking questions'); it falls between the entirely-vague anchor (1) and the minimal-domain anchor (3), clearly below the midpoint.

2 / 5

Completeness

It provides a vague procedural 'what' (check for context, ask only uncovered questions) and no 'when to use this skill' clause at all, matching the 'vague what and no when' / missing-trigger anchor; the rubric caps completeness at 3 for a missing 'Use when...' clause and this is weaker than that, so 2.

2 / 5

Trigger Term Quality

It contains no natural user-facing trigger keywords like 'menus', 'buttons', 'toolbar', or 'HIG'; the only phrases are internal process directives ('before asking questions', 'information not already covered'), so it sits between the no-keywords anchor (1) and the generic-keywords anchor (3), noticeably below midpoint.

2 / 5

Distinctiveness Conflict Risk

The wording ('before asking questions', 'use existing context') is a generic instruction applicable to almost any skill and gives no signal that distinguishes an Apple HIG menus/buttons skill, putting it between the entirely-generic anchor (1) and the broad-overlap anchor (3), noticeably below the midpoint.

2 / 5

Total

8

/

20

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

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.