Index of every page on this site: llms.txt
All skills
raintree-technology avatar

/hig-technologies

@a0f1e4e
Run it yourself

Apple HIG guidance for Apple technology integrations: Siri, Apple Pay, HealthKit, HomeKit, ARKit, machine learning, generative AI, iCloud, Sign in with Apple, SharePlay, CarPlay, Game Center, in-app purchase, NFC, Wallet, VoiceOver, Maps, Mac Catalyst, and more. Use when asked about: "Siri integration", "Apple Pay", "HealthKit", "HomeKit", "ARKit", "augmented reality", "machine learning", "generative AI", "iCloud sync", "Sign in with Apple", "SharePlay", "CarPlay", "in-app purchase", "NFC", "VoiceOver", "Maps", "Mac Catalyst". Also use when the user says "how do I integrate Siri," "what are the Apple Pay guidelines," "how should my AR experience work," "how do I use Sign in with Apple," or asks about any Apple framework or service integration. Cross-references: hig-inputs for input methods, hig-components-system for widgets.

Use this Skill: https://skilld.dev/gh/raintree-technology/hig-doctor/hig-technologies

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈214 tokens for metadata: the name and description. ≈1.7k when used: this file. ≈25k more on demand in 28 files.

Description uses 10.7% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈855 characters, or 10.7%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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

Reference Topic Key content
siri.md Siri Intents, shortcuts, voice interaction, App Shortcuts
apple-pay.md Apple Pay Payment buttons, checkout flow, security
tap-to-pay-on-iphone.md Tap to Pay Merchant flows, contactless payment
in-app-purchase.md In-app purchase Subscriptions, one-time purchases, transparency
healthkit.md HealthKit Health data access, privacy, permissions
carekit.md CareKit Care plans, tasks, health management
researchkit.md ResearchKit Studies, informed consent, data collection
homekit.md HomeKit Smart home control, device state, scenes
augmented-reality.md ARKit Spatial context, surface detection, setup
machine-learning.md Core ML Predictions, smart features, confidence handling
generative-ai.md Generative AI Attribution, editing, responsible AI, uncertainty
icloud.md iCloud CloudKit, cross-device sync, conflict resolution
sign-in-with-apple.md Sign in with Apple Authentication, privacy, button styles
id-verifier.md ID Verifier Identity verification, document scanning
shareplay.md SharePlay Shared experiences, participant presence
airplay.md AirPlay Media streaming, Now Playing, wireless display
carplay.md CarPlay Driver safety, permitted app types, large targets
game-center.md Game Center Achievements, leaderboards, multiplayer
voiceover.md VoiceOver Screen reader, labels, traits, accessibility
wallet.md Wallet Passes, tickets, loyalty cards
nfc.md NFC Tag reading, quick interactions, App Clips
maps.md Maps Location display, annotations, directions
mac-catalyst.md Mac Catalyst iPad to Mac, menu bar, keyboard, pointer
live-photos.md Live Photos Motion capture, playback, editing
imessage-apps-and-stickers.md iMessage apps Messages extension, stickers, compact UI
shazamkit.md ShazamKit Audio recognition, music identification
always-on.md Always-on display Dimmed state, power efficiency, reduced updates
photo-editing.md Photo editing System 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

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts2mo4 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    The skill is a documentation resource providing guidance based on Apple's Human Interface Guidelines. It contains only markdown reference files and does not include any executable code or risky behaviors.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: LOW · No issues

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at a0f1e4e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 weeks ago.

Activeupdated 9 months ago
version
1.0.0

README badge

README badge for raintree-technology/hig-doctor/hig-technologies