CtrlK
BlogDocsLog inGet started
Tessl Logo

apple-hig

Apple Human Interface Guidelines as 14 agent skills covering platforms, foundations, components, patterns, inputs, and technologies for iOS, macOS, visionOS, watchOS, and tvOS.

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 ./skills/apple-hig/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

53%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 lean, well-organized catalogue stub, but as a standalone SKILL.md it provides almost no executable guidance: the actual workflow is delegated to an external GitHub URL with no install steps, and 'What it does' merely duplicates the frontmatter description. It works as an advertisement entry but scores weakly on actionability and workflow clarity.

Suggestions

Replace the 'open https://github.com/...' inspection step with concrete, executable install commands (e.g. git clone of the upstream repo and a copy/symlink into the skills directory) so the agent can act without browsing.

Drop the 'What it does' section that duplicates the frontmatter description verbatim, and instead summarize what the 14 sub-skills cover and when to reach for which.

Add a short validation step after install (e.g. how to confirm the apple-hig skill is discoverable) so the workflow has a checkpoint for error recovery.

DimensionReasoningScore

Conciseness

The body is short and lean with no explanation of concepts Claude already knows; the one redundancy is the 'What it does' section repeating the frontmatter description verbatim. Not 5 because that duplicated block does not earn its tokens; not 3 because there is no padding or unnecessary explanation beyond that.

4 / 5

Actionability

The core instruction 'install the upstream bundle into your active agent's skills directory' is a high-level hint with no specific steps or commands; the only concrete command is 'open https://github.com/raintree-technology/apple-hig-skills', which inspects rather than executes anything. Anchor 2 ('minimal concrete guidance; high-level hints but missing the specific steps') fits; not 3 because there is no executable step toward the actual task, and not 1 because a concrete command and a concrete next action (invoke by name) do exist.

2 / 5

Workflow Clarity

A rough sequence is present (inspect upstream README, install bundle, invoke by name or trigger phrase) but the steps are loosely defined and there are no checkpoints or validation. Not 4 because 'install the upstream bundle' has no concrete sub-steps; not 2 because the ordering is coherent and the final invocation step is specific. This is a non-destructive skill, so no hard cap applies.

3 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the body is under 50 lines with well-organized sections ('What it does', 'Source', 'How to use'). Not 5 because all substantive content is deferred to an external URL rather than to clearly signaled one-level-deep bundled references, leaving the skill with no local detail layer; not 3 because what is present is well structured and the deferral is explicitly signaled.

4 / 5

Total

13

/

20

Passed

Description

60%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 identifies a clear, distinctive niche (Apple HIG across five platforms) with good natural keyword coverage, but it reads as a catalogue blurb rather than a capability statement: it lists what the bundle covers without a single concrete action, and it omits any 'Use when' trigger guidance, capping completeness at 3.

Suggestions

Add explicit trigger guidance to the description, e.g. 'Use when designing or reviewing UI for Apple platforms (iOS, macOS, visionOS, watchOS, tvOS), applying Apple HIG conventions, or when the user mentions HIG or Apple design guidelines.'

Replace the passive coverage listing with concrete actions, e.g. 'Applies Apple Human Interface Guidelines to review and design UI... ' so the description states what the skill does, not just what it contains.

Include common synonyms users would naturally say ('HIG', 'SwiftUI design', 'app design', 'UI guidelines') to lift trigger term coverage toward comprehensive.

DimensionReasoningScore

Specificity

The description names the domain ("Apple Human Interface Guidelines as 14 agent skills") and enumerates coverage areas ("platforms, foundations, components, patterns, inputs, and technologies") but contains no concrete actions or verbs describing what the skill actually does. Anchor 2 ('names the domain but actions are minimal or generic') is the closest fit; not 3 because even one or two concrete actions are absent, and not 1 because the domain and coverage are specifically enumerated.

2 / 5

Completeness

There is a clear 'what' ("Apple Human Interface Guidelines as 14 agent skills covering platforms, foundations, components, patterns, inputs, and technologies") but no 'Use when...' clause or equivalent explicit trigger guidance anywhere in the description, which per judging guidelines caps completeness at 3. Not 4 because the 'when' is entirely absent rather than merely improvable.

3 / 5

Trigger Term Quality

Natural terms users would say are present: "Apple Human Interface Guidelines" plus all five platforms (iOS, macOS, visionOS, watchOS, tvOS). Not 5 because common synonyms and variations are missing (e.g. "HIG", "SwiftUI", "UI guidelines", "app design"); not 3 because coverage of the primary platform names is good rather than partial.

4 / 5

Distinctiveness Conflict Risk

"Apple Human Interface Guidelines" names a clear niche with distinct triggers for iOS, macOS, visionOS, watchOS, and tvOS, giving minimal conflict risk with other skills. Not 4 because the enumerated platform list makes overlap with non-Apple design skills unlikely; the only slightly generic term is "human interface".

5 / 5

Total

14

/

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
nexu-io/open-design
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.