CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hig-components-controls

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

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-controls/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

72%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 well-structured overview for an advisory skill: dense, platform-specific control principles, a complete and verified 14-file reference index with easy navigation, and a defined output format. The weaknesses are an implicit rather than explicit workflow sequence and small amounts of filler (duplicated description line, vacuous "When to Use" section, branding footer).

Suggestions

Add an explicit numbered workflow and order sections to follow it, e.g.: 1. Check .claude/apple-design-context.md 2. Ask any unresolved "Questions to Ask" 3. Select the control using Key Principles and the reference files 4. Produce the answer in "Output Format".

Delete the filler "When to Use" section ("This skill is applicable to execute the workflow or actions described in the overview.") and the duplicated first line to recover tokens.

DimensionReasoningScore

Conciseness

The 11 Key Principles are dense, substantive one-liners ("Toggles for binary states. On or off.", "2-5 items, roughly equal importance, short labels") with platform-specific facts Claude cannot be assumed to know. Minor trimmable waste keeps this at anchor 4 rather than 5: the body's first line duplicates the frontmatter description verbatim, the trailing "When to Use" section is pure filler ("This skill is applicable to execute the workflow or actions described in the overview."), and the branding footer adds tokens without guidance value.

4 / 5

Actionability

For an instruction-only skill the guidance is concrete and executable: "In Settings-style screens, changes take effect immediately. In modal forms, changes commit on confirmation", "Configure keyboard type to match expected input (email, URL, number)", "Display current value next to the stepper with reasonable min/max bounds", plus a four-part Output Format defining the deliverable. It falls short of anchor 5 only because there is no worked example of the recommended output and the validation guidance stays high-level.

4 / 5

Workflow Clarity

All workflow components exist (context check "before asking questions", a "Questions to Ask" intake list, decision principles with references, and an "Output Format"), but they are never sequenced into an explicit process — the document even places "Questions to Ask" after "Output Format", so the actual order (check context → ask → decide → produce output) must be inferred. This matches anchor 3 ("sequence present but checkpoints missing or implicit") rather than anchor 4's explicitly numbered steps.

3 / 5

Progressive Disclosure

The body is a genuine overview that keeps details in the bundle: the Reference Index table lists all 14 references with topic and key-content columns, every referenced path (controls.md, toggles.md, segmented-controls.md, sliders.md, steppers.md, pickers.md, combo-boxes.md, text-fields.md, text-views.md, labels.md, token-fields.md, virtual-keyboards.md, rating-indicators.md, gauges.md) was verified to exist in references/, and they are one level deep. This closely matches the anchor-5 pattern of a lean overview with well-signaled one-level-deep references.

5 / 5

Total

16

/

20

Passed

Description

20%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 fails at its primary job: it describes a context-checking intake behavior while never stating that the skill provides Apple HIG selection and input control guidance, nor when to use it. It is imperative rather than third-person, contains no natural trigger terms, and would conflict with sibling design skills sharing the same convention.

Suggestions

Rewrite in third person stating the actual capability, e.g.: "Recommends Apple HIG selection and input controls (toggles, segmented controls, sliders, pickers, steppers, text fields, combo boxes) with guidance on state, validation, and accessibility."

Add an explicit trigger clause: "Use when choosing iOS/macOS controls for a settings screen or form, or when the user mentions HIG, toggles, sliders, pickers, or segmented controls."

Keep the .claude/apple-design-context.md check in the body only (it is already repeated there) so the description stays focused on capabilities and triggers.

DimensionReasoningScore

Specificity

The explicit actions ("Check for .claude/apple-design-context.md before asking questions", "only ask for information not already covered") are concrete but describe an intake behavior rather than the skill's actual capabilities — the domain (Apple HIG, selection/input controls) is never named. The voice is imperative/second-person ("Check", "Use") rather than the required third person, which triggers the -1 penalty per the judging guidelines, bringing this from 2 to 1.

1 / 5

Completeness

There is no "Use when..." clause or equivalent trigger guidance (which alone caps completeness at 3), and the stated "what" — a context-file checking procedure — does not convey what the skill actually does (recommend Apple HIG selection and input controls). Both what-the-skill-does and when-to-use-it are effectively unanswered, matching anchor 2 ("Has a vague 'what' and no 'when'") better than anchor 3, whose 'what' clearly describes the skill's function.

2 / 5

Trigger Term Quality

Only one or two generic keywords ("context", "information", "questions") appear; the natural phrases a user would say when needing this skill (toggle, switch, slider, picker, segmented control, settings screen, Apple HIG, iOS/macOS form) are entirely absent. Anchor 2 ("One or two generic keywords; missing the natural phrases users say") is the best fit; anchor 1 is too harsh only because "apple-design-context.md" carries a faint domain signal.

2 / 5

Distinctiveness Conflict Risk

The text "Use existing context and only ask for information not already covered" could describe virtually any skill in a suite that shares this context-file convention, creating high overlap risk with the sibling hig-* skills listed in the body. The filename "apple-design-context.md" provides a weak domain signal, keeping this just above anchor 1's entirely-generic example ("Helps with code and documents").

2 / 5

Total

7

/

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.

Validation — 15 / 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

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/hig-components-controls/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.