Back to Skills

hig-technologies

raintree-technology
Updated 4 days ago
78
9
78
View on GitHub
Metaaidesign

About

This skill provides Apple's Human Interface Guidelines for integrating Apple technologies and frameworks like Siri, ARKit, HealthKit, and Sign in with Apple. Use it when developers ask about implementation guidelines, best practices, or "how to" questions for any Apple service integration. It specifically covers technical integration patterns rather than general UI components.

Quick Install

Claude Code

Recommended
Primary
npx skills add raintree-technology/claude-starter -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/raintree-technology/claude-starter
Git CloneAlternative
git clone https://github.com/raintree-technology/claude-starter.git ~/.claude/skills/hig-technologies

Copy and paste this command in Claude Code to install this skill

Documentation

Apple HIG: Technologies

Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered.

Key Principles

  1. Apple technologies extend app capabilities through system integration. Each technology has established user-facing patterns; deviating creates confusion and erodes trust.

  2. Privacy and user control are paramount. Especially for health, payment, and identity technologies. Request only needed data, explain why, respect choices.

  3. Siri: natural, predictable, recoverable. Clear conversational intent phrases that complete quickly and confirm results. Support App Shortcuts for proactive suggestions. Handle errors with clear fallbacks.

  4. Payments: transparent and frictionless. Standard Apple Pay button styles. Never ask for card details when Apple Pay is available. Clearly describe what the user is buying, the price, and whether it's one-time or subscription.

  5. Health data is deeply personal. Explain the health benefit before requesting access. CareKit tasks should be encouraging. ResearchKit consent flows must be thorough, readable, and respect autonomy.

  6. HomeKit: simple and reliable. Immediate response when controlling devices. Clear device state. Graceful handling of connectivity issues.

  7. AR: genuine value, not gimmicks. Use AR when spatial context improves understanding. Guide setup (surface, lighting, space). Provide clear exit back to standard interaction.

  8. ML and generative AI: enhance without surprising. Smart suggestions, image recognition, text prediction. Clearly attribute AI-generated content. Controls to edit, regenerate, or dismiss. Let users correct mistakes.

  9. Sign in with Apple as top option. Standard button styles. Respect email hiding preference. ID Verifier: guided flows, don't store sensitive data beyond what verification requires.

  10. iCloud: invisible and reliable sync. Data appears on all devices without manual intervention. Handle conflicts gracefully. Never lose data.

  11. SharePlay: real-time participation. Support multiple participants, show presence, handle latency. AirPlay: appropriate Now Playing metadata.

  12. CarPlay: driver safety first. Minimize interaction complexity, large touch targets, no distracting content. Only permitted app types: audio, messaging, EV charging, navigation, parking, quick food ordering.

  13. Accessibility is a baseline requirement. Every element has a meaningful VoiceOver label, trait, and action. Support Dynamic Type, Switch Control, and other assistive technologies. Test entirely with VoiceOver enabled.

Reference Index

ReferenceTopicKey content
siri.mdSiriIntents, shortcuts, voice interaction, App Shortcuts
apple-pay.mdApple PayPayment buttons, checkout flow, security
tap-to-pay-on-iphone.mdTap to PayMerchant flows, contactless payment
in-app-purchase.mdIn-app purchaseSubscriptions, one-time purchases, transparency
healthkit.mdHealthKitHealth data access, privacy, permissions
carekit.mdCareKitCare plans, tasks, health management
researchkit.mdResearchKitStudies, informed consent, data collection
homekit.mdHomeKitSmart home control, device state, scenes
augmented-reality.mdARKitSpatial context, surface detection, setup
machine-learning.mdCore MLPredictions, smart features, confidence handling
generative-ai.mdGenerative AIAttribution, editing, responsible AI, uncertainty
icloud.mdiCloudCloudKit, cross-device sync, conflict resolution
sign-in-with-apple.mdSign in with AppleAuthentication, privacy, button styles
id-verifier.mdID VerifierIdentity verification, document scanning
shareplay.mdSharePlayShared experiences, participant presence
airplay.mdAirPlayMedia streaming, Now Playing, wireless display
carplay.mdCarPlayDriver safety, permitted app types, large targets
game-center.mdGame CenterAchievements, leaderboards, multiplayer
voiceover.mdVoiceOverScreen reader, labels, traits, accessibility
wallet.mdWalletPasses, tickets, loyalty cards
nfc.mdNFCTag reading, quick interactions, App Clips
maps.mdMapsLocation display, annotations, directions
mac-catalyst.mdMac CatalystiPad to Mac, menu bar, keyboard, pointer
live-photos.mdLive PhotosMotion capture, playback, editing
imessage-apps-and-stickers.mdiMessage appsMessages extension, stickers, compact UI
shazamkit.mdShazamKitAudio recognition, music identification
always-on.mdAlways-on displayDimmed state, power efficiency, reduced updates
photo-editing.mdPhoto editingSystem photo editor, filters, adjustments

Output Format

  1. Implementation checklist -- step-by-step requirements per Apple's guidelines.
  2. Required vs optional features for approval.
  3. Privacy and permission requirements -- data access, usage descriptions.
  4. User-facing flow from permission prompt through task completion.
  5. Testing guidance -- key scenarios including edge cases.

Questions to Ask

  1. Which Apple technology?
  2. Core use case?
  3. Which platforms?
  4. API requirements and entitlements reviewed?
  5. What data or permissions needed?

Related Skills

  • hig-inputs -- Input methods interacting with technologies (voice for Siri, Pencil for AR, gestures for Maps)
  • hig-components-system -- Widgets, complications, Live Activities surfacing technology data
  • hig-components-status -- Progress indicators for technology operations (sync, payment, AR loading)

Built by Raintree Technology · More developer tools

GitHub Repository

raintree-technology/claude-starter
Path: templates/.claude/skills/hig-technologies
0
ai-toolsanthropicclaudeclaude-aiclaude-codedeveloper-tools

Related Skills

content-collections

Meta

This skill provides a production-tested setup for Content Collections, a TypeScript-first tool that transforms Markdown/MDX files into type-safe data collections with Zod validation. Use it when building blogs, documentation sites, or content-heavy Vite + React applications to ensure type safety and automatic content validation. It covers everything from Vite plugin configuration and MDX compilation to deployment optimization and schema validation.

View skill

polymarket

Meta

This skill enables developers to build applications with the Polymarket prediction markets platform, including API integration for trading and market data. It also provides real-time data streaming via WebSocket to monitor live trades and market activity. Use it for implementing trading strategies or creating tools that process live market updates.

View skill

creating-opencode-plugins

Meta

This skill helps developers create OpenCode plugins that hook into 25+ event types like commands, files, and LSP operations. It provides the plugin structure, event API specifications, and implementation patterns for JavaScript/TypeScript modules. Use it when you need to intercept, monitor, or extend the OpenCode AI assistant's lifecycle with custom event-driven logic.

View skill

sglang

Meta

SGLang is a high-performance LLM serving framework that specializes in fast, structured generation for JSON, regex, and agentic workflows using its RadixAttention prefix caching. It delivers significantly faster inference, especially for tasks with repeated prefixes, making it ideal for complex, structured outputs and multi-turn conversations. Choose SGLang over alternatives like vLLM when you need constrained decoding or are building applications with extensive prefix sharing.

View skill