CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hig-platforms

Apple Human Interface Guidelines for platform-specific design.

Quality

67%

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

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

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 with exemplary progressive disclosure — per-platform detail is pushed one level deep into verified reference files, clearly indexed by topic. Weaknesses are moderate: the platform summaries restate knowledge Claude already has, and the 'When to Use' filler section and attribution footer add tokens without guidance.

Suggestions

Delete the vacuous 'When to Use' section ('This skill is applicable to execute the workflow or actions described in the overview.') and consider trimming the attribution footer — neither adds guidance.

Tighten the eight 'Key Principles' entries to only the non-obvious deltas (e.g. keep 'visionOS: eye tracking for targeting, indirect gestures'; drop widely known facts like macOS having menu bars and keyboard shortcuts).

Add one brief worked example of the 'Platform differences table' output format (2 rows covering navigation, input, layout) so the expected output is unambiguous.

DimensionReasoningScore

Conciseness

The body is mostly efficient — compact per-platform summaries, a tight decision framework, and a reference table rather than inlined platform docs — but the eight 'Key Principles' entries restate HIG basics Claude already knows (e.g. 'macOS: pointer and keyboard. Dense information display... menu bars, toolbars'), and the trailing sections are padding: the 'When to Use' section ('This skill is applicable to execute the workflow or actions described in the overview') is vacuous filler, and the attribution footer adds tokens without guidance. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the minor-trim level 4.

3 / 5

Actionability

As an instruction-only skill, the guidance is concrete: an explicit context-check step ('Check for .claude/apple-design-context.md before asking questions'), five named discovery questions, a decision framework with concrete translation examples ('A macOS sidebar becomes a tab bar on iPhone'), and a specified output format (recommendations citing HIG sections, a platform differences table, implementation notes with recommended APIs). It stops short of level 5 because no worked example of the expected output (e.g. a sample differences table or citation format) is provided, leaving minor gaps in what 'citing relevant HIG sections' should look like.

4 / 5

Workflow Clarity

A coherent sequence is present: check existing context first, ask the five listed discovery questions, apply the five-step decision framework, then produce output in the three-part specified format. The reference index maps each platform to the file to consult per step. No validation checkpoints exist, but the skill is advisory (no destructive or batch operations), so the level-3 cap does not apply; it is not a 5 because there is no explicit feedback loop (e.g. re-checking recommendations against the framework or verifying cited HIG sections).

4 / 5

Progressive Disclosure

The body is a genuine overview: all seven per-platform guides live one level deep in references/ (all files verified to exist), and the Reference Index table clearly signals each file with its topic and key content ('designing-for-watchos.md | watchOS | Glanceable UI, Digital Crown, complications...'). Content is appropriately split and navigation is easy, matching the level-5 anchor exactly.

5 / 5

Total

16

/

20

Passed

Description

48%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 its domain clearly but reads like a title rather than a capability statement: it lists no actions, includes no platform-name trigger terms, and provides no 'use when' guidance. It would benefit most from an explicit trigger clause enumerating the platforms it covers.

Suggestions

Add an explicit 'when' clause, e.g. 'Use when designing or adapting UI for Apple platforms (iOS, iPadOS, macOS, tvOS, visionOS, watchOS) or when the user mentions Apple HIG, Human Interface Guidelines, or platform-specific design.'

State 1-2 concrete actions, e.g. 'Provides Apple Human Interface Guidelines checklists and adaptation strategies for platform-specific design; evaluates designs against each platform's conventions.'

Include the platform names (iOS, macOS, watchOS, etc.) as trigger terms so users asking about a specific platform naturally match this skill.

DimensionReasoningScore

Specificity

The description 'Apple Human Interface Guidelines for platform-specific design' names the domain (Apple HIG, platform-specific design) but states no concrete actions — it is a topic phrase rather than a list of capabilities. It is above the level-1 'pure abstract language' anchor because the domain is clearly identified, but it matches 'names the domain but actions are minimal or generic' with no verbs or tasks at all.

2 / 5

Completeness

The 'what' is conveyed reasonably clearly (Apple HIG guidance applied to platform-specific design), but the 'when' is completely missing — there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 2 because the what is more than vague; it is not a 4 because no when-clause exists at all.

3 / 5

Trigger Term Quality

'Apple' and 'Human Interface Guidelines' (HIG) are natural terms a user would say, but the most common trigger phrases for this skill — the platform names themselves (iOS, iPadOS, macOS, tvOS, visionOS, watchOS, SwiftUI, UI design) — are entirely absent. This fits 'some relevant keywords but missing common variations or synonyms'.

3 / 5

Distinctiveness Conflict Risk

'Apple Human Interface Guidelines for platform-specific design' carves out a clear niche and would not trigger for unrelated skills, and the Apple/HIG terms are distinctive. However, the skill body lists four closely related sibling skills (hig-foundations, hig-patterns, hig-components-layout, hig-components-content) whose descriptions could plausibly overlap, matching 'mostly distinct; minor overlap risk with closely related skills'.

4 / 5

Total

12

/

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