CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

apple-design

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

Quality

80%

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 ./.agents/skills/apple-design/SKILL.md

The canonical home for this skill is apple-design in emilkowalski/skills

SKILL.md
Quality
Evals
Security

Quality

Content

63%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 content is unusually rich in non-generic, actionable specifics — real parameter values, formulas, and working code — organized into clearly headed, navigable sections with a quick-reference table. Its weaknesses are length (nearly 300 inlined lines with some padding in the principles/process sections) and no progressive disclosure into reference files, plus a few fragmentary code examples.

Suggestions

Move the self-contained reference material — typography (§15), the eight design principles (§16), and process notes (§17) — into files under references/ and keep one-line pointers in SKILL.md, reducing the main file's token footprint.

Trim §16 and §17 to the tactical rules and drop restatements of generally known design philosophy (e.g. expanded definitions of Simplicity, Craft, Delight) to improve conciseness.

Complete the fragmentary code examples: fill in the pointerdown velocity-history tracking and replace the undefined `animateSpringTo` helper with a real spring-library call (e.g. Motion's `animate`) so snippets are copy-paste ready.

DimensionReasoningScore

Conciseness

The body is dense with genuinely non-obvious specifics (damping/response values, the exponential-decay projection, the rubber-band formula), but at ~290 lines it includes discursive material — the eight design principles in §16 and the process notes in §17 — that restates ideas Claude partly knows and could be tightened. This matches 'mostly efficient but could be tightened' rather than 4, which would require only minor trims.

3 / 5

Actionability

Highly concrete: exact spring parameter tables, executable CSS/JS for springs, projection, rubber-banding, and reduced-motion media queries. Below 5 because a few snippets are fragments (the pointerdown handler trails off with '// ...track position history' and §6 calls an undefined `animateSpringTo` helper), leaving minor gaps in copy-paste readiness.

4 / 5

Workflow Clarity

This is a knowledge/reference skill, not a multi-step process, so validation checkpoints aren't applicable; the numbered sections and the closing Quick Reference table make lookup unambiguous and the 'Initial Response' instruction is explicit. Not 5 because no explicit guidance sequences how to apply the principles when building or reviewing an interface (e.g. a review checklist order).

4 / 5

Progressive Disclosure

No bundle files exist and all ~290 lines live in SKILL.md. Sections are well-organized with clear headers, but substantial reference material — typography (§15) and the eight design principles (§16) — is inlined where it 'should be separate' per the anchor-3 description, and a Quick Reference table partially duplicates earlier sections. Not 2 because structure and navigation are good, not merely minimal.

3 / 5

Total

14

/

20

Passed

Description

87%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.

A strong description: it states a clear niche, lists concrete topic areas, and carries an explicit, detailed 'Use when' trigger clause covering gestures, springs, materials, typography, and accessibility. Its only weakness is topical phrasing rather than action verbs and a few missing natural synonyms.

DimensionReasoningScore

Specificity

The description names many concrete capability areas — 'gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion' — matching the 'several specific actions; minor gaps' anchor. It stays below 5 because the framing is topical coverage rather than a list of discrete actions, and above 3 because coverage is broad rather than 1–2 items.

4 / 5

Completeness

It explicitly answers both questions: the 'what' ('Apple's approach to interface design and fluid, physical motion, translated for the web') and an explicit 'Use when building or reviewing…' clause with concrete trigger phrases, matching the top anchor. Not 4 because the 'when' is already fully explicit and specific, not merely present.

5 / 5

Trigger Term Quality

Natural phrases a user would actually say are well covered: 'spring animations', 'drag/swipe', 'reduced-motion', 'Apple-style interfaces'. It falls short of the 'comprehensive coverage including synonyms' anchor because common variations like 'framer motion', 'haptics', 'iOS-like feel', or library names users might mention are absent.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche — Apple-derived fluid-motion and design guidance translated to web tech — with triggers unlikely to fire for unrelated skills. Minor theoretical overlap with a generic web-design skill exists, but the anchor-5 example's risk profile is equivalent.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

englishstreetventures/osn

Path

.agents/skills/apple-design/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.