apple-design

$npx mdskill add JasonxzWen/harness-hub/apple-design

Load Apple interface principles for gesture-driven UI and interactions

  • Ensures direct manipulation and velocity continuity in physical gestures.
  • Depends on causal input and current presentation value for animation decisions.
  • Projects momentum before snapping to ensure smooth transitions.
  • Preserves user agency, spatial consistency, and reduced-motion options.

SKILL.md

.github/skills/apple-designView on GitHub ↗
---
name: apple-design
description: Load when a frontend task needs Apple-platform design guidance or physical, gesture-driven, velocity-aware, interruptible interaction; skip generic visual styling and use review-animations for report-only motion review.
license: MIT
metadata:
  source: "emilkowalski/skills skills/apple-design"
  upstream_commit: "7bb7061b5cf7de15ea1aeaf00fbd9e6592a20fce"
  adaptation: "Narrow routing and progressive disclosure; volatile API and browser claims require current evidence."
---

# Apple Design

Use Apple interface principles when the platform context or interaction genuinely benefits from direct manipulation, velocity continuity, interruptibility, spatial consistency, or physical feedback. Do not apply Apple visual styling by default.

Read [references/interface-principles.md](references/interface-principles.md) when designing or implementing gesture-driven UI, springs, drag or sheet interactions, momentum, translucent materials, typography, or accessibility adaptations.

## Core Contract

- Start feedback at the causal input and keep direct manipulation continuous.
- Animate from the current presentation value and preserve velocity when an interaction is interrupted.
- Project momentum before choosing a snap target; resist softly at boundaries.
- Preserve spatial origin, reversible paths, user agency, and reduced-motion alternatives.
- Match the product's existing design system and interaction language before importing a platform convention.
- Reference examples do not authorize dependency additions; prefer existing project primitives and evaluate any new package under the task's normal dependency policy.
- Verify current browser and animation-library behavior before relying on version-sensitive API or performance claims.

## Boundaries

This Skill owns Apple and physical-interaction guidance. It does not own general frontend styling, animation terminology, or review verdicts. Use `frontend-design` for production UI, `animation-vocabulary` for naming, and `review-animations` for report-only motion review.

More from JasonxzWen/harness-hub

SkillDescription
agent-interaction-auditLoad when the user asks for private agent interaction audits from local Codex/Claude Code traces, task profiles, tool-call decisions, collaboration bottlenecks, prompt/rule or automation-log audits, closeout retrospectives, or evidence-backed Skill/project-rule/Eval/SOP/OKF improvements.
agent-reachLoad when a task needs read-only internet research or content retrieval through an already installed Agent Reach CLI; diagnose available backends first, never install, upgrade, authenticate, configure, or copy credentials on the user's behalf.
animation-vocabularyLoad when a user describes a Web animation or motion effect without knowing its name and needs the precise term or close alternatives; use only for naming, not design, implementation, or review.
beautiful-feishu-whiteboardLoad when creating or restyling a polished editable Feishu or Lark whiteboard, infographic, diagram, poster, or visual explainer; do not load for generic SVGs, static images, or other whiteboard platforms.
clone-websiteLoad when the user explicitly asks to clone, reverse-engineer, or rebuild a website they own or are authorized to reproduce; do not load for generic redesign, inspiration, scraping, phishing, impersonation, or copying third-party brands.
codebase-to-courseLoad when a user wants a source-backed interactive HTML course that explains how a codebase works; do not load for chat tutoring, repository review, articles, slide decks, or general browser artifacts.
context-guidanceFixture skill used to represent an additional standard skill context surface.
decision-uiLoad when Codex 即将要求用户在 2-3 个互斥方案中做真实决定、准备询问阻塞性澄清问题或需要确认高影响取舍;将选择转换为宿主原生可点击 UI,并在工具不可用时诚实文本回退。不要用于低风险实现细节、只有一个合理答案的问题、普通信息采集或不需要用户决策的完成汇报。
design-taste-frontendLoad when a task needs anti-template frontend visual direction, design-read calibration, or pre-flight critique for landing pages, portfolios, marketing pages, or redesigns; do not load for dashboards, data tables, multi-step product UI, routine frontend logic, HTML reports, slide decks, or generic code explanation.
effective-interactLoad when agent pauses to report relatively complex information needing Chinese-first clear complex communication, alignment, multi-option choice, status/incident, long-task fact ledgers, implementation plans, reviews, maps, explainers, evidence, risks, validation, handoff; choose plain text/Markdown/visual Markdown/HTML by decision cost; do not load merely because answer is long; skip trivial chat/bundled apps.