agentleFS
raintree-technologyraintree-technology/hig-doctor/skills/hig-technologies/SKILL.md

hig-technologies

Skill153 starsChanged 9 months agoMITView on GitHub

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.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Check for .claude/apple-design-context.md before asking questions.

    line 20
  2. Distinctive:

    AR: genuine value, not gimmicks: Use AR when spatial context improves understanding.

    line 36
  3. Distinctive:

    Accessibility is a baseline requirement: Every element has a meaningful VoiceOver label, trait, and action.

    line 48

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.