CtrlK
BlogDocsLog inGet started
Tessl Logo

hig-components-content

Apple Human Interface Guidelines for content display components.

53

Quality

60%

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

The canonical home for this skill is hig-components-content 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, lean overview with excellent progressive disclosure — it delegates detail to eight real one-level-deep reference files and provides a concrete component-selection guide and output format. Its main weakness is workflow clarity: the process is only implicitly sequenced rather than laid out as explicit numbered steps with checkpoints.

Suggestions

Replace the boilerplate "When to Use" line with an explicit numbered workflow (e.g. 1. Check .claude/apple-design-context.md; 2. Ask the clarifying Questions; 3. Select via the Component Selection Guide and consult the referenced file; 4. Deliver per the Output Format) to raise workflow clarity.

Add one short worked example under Output Format showing a filled-in recommendation (component, config, accessibility, platform notes) so the guidance is copy-paste ready.

Trim the marketing footer and the generic "This skill is applicable to execute the workflow..." line to push conciseness toward a 5.

DimensionReasoningScore

Conciseness

The body is mostly lean — tight principle bullets and compact tables that assume Claude's competence — with only minor trimmable filler such as the boilerplate "This skill is applicable to execute the workflow or actions described in the overview" and the marketing footer, matching the score-4 anchor of efficient content with minor over-explanation. It is not 5 because those filler lines do not earn their tokens.

4 / 5

Actionability

As an instruction-only skill it gives concrete, specific guidance: a Component Selection Guide mapping needs to named components with platform/version notes, and a four-part Output Format checklist, matching score-4's "mostly executable guidance with minor gaps". It is not 5 because the Output Format lists what to include without a worked example of each part.

4 / 5

Workflow Clarity

An implicit sequence exists (check the context file, ask the clarifying Questions, select via the Selection Guide, deliver per the Output Format) but it is never framed as an explicit numbered workflow and checkpoints are implicit, matching the score-3 anchor. It is not 4 because the steps are scattered across sections rather than clearly sequenced with explicit checkpoints; no destructive/batch cap applies since the skill is advisory.

3 / 5

Progressive Disclosure

SKILL.md is a clear overview that points to eight one-level-deep reference files via a well-signaled Reference Index table, and all eight referenced files (charts.md, collections.md, image-views.md, image-wells.md, color-wells.md, web-views.md, activity-views.md, lockups.md) exist in references/, matching the score-5 anchor of a clear overview with well-signaled one-level-deep references and easy navigation.

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 a specific domain but lacks action verbs and any explicit "Use when..." trigger guidance, which caps completeness and limits trigger-term quality. It is reasonably distinct from generic skills but shares surface triggers with sibling HIG skills.

Suggestions

Add concrete actions in third person (e.g. "Recommends and configures Apple HIG content display components — charts, collection views, image views, web views, lockups") to lift specificity.

Append an explicit "Use when..." clause naming natural trigger phrases users would say (HIG, collection view, Swift Charts, WKWebView, tvOS lockups) to raise completeness and trigger-term quality.

Sharpen the boundary versus sibling HIG skills by noting this skill covers content-display components specifically, not layout containers or foundational color/typography.

DimensionReasoningScore

Specificity

The description names the domain ("Apple Human Interface Guidelines for content display components") but states no concrete actions — it is a topic label, not a capability verb list, matching the score-2 anchor of naming the domain with minimal/generic actions. It is above 1 because the domain is specific rather than entirely vague.

2 / 5

Completeness

There is a recognizable "what" (the HIG subject area for content components) but no "Use when..." trigger clause, so completeness is capped at 3 per the judging guidelines; it is not 2 because the "what" is specific rather than vague, and not 4 because the "when" is entirely absent rather than weakly explicit.

3 / 5

Trigger Term Quality

Terms like "Apple Human Interface Guidelines" and "content display components" are relevant and somewhat natural, but it omits common variations/synonyms users would actually say (e.g. HIG, charts, collection view, web view, lockups), matching the score-3 anchor of some relevant keywords missing common variations.

3 / 5

Distinctiveness Conflict Risk

"Content display components" carves a fairly distinct niche out of the Apple HIG space with minor overlap risk against closely related sibling skills (hig-foundations, hig-components-layout, hig-patterns, hig-platforms), matching the score-4 anchor; it is not 5 because the broad "Apple Human Interface Guidelines" handle could still pull in those sibling 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.

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.