axiom-core-spotlight-ref
Use when indexing app content for Spotlight search, using NSUserActivity for prediction/handoff, or choosing between CSSearchableItem and IndexedEntity - covers Core Spotlight framework and NSUserActivity integration for iOS 9+
npx skills add majiayu000/claude-skill-registry --skill axiom-core-spotlight-ref-charleswiltgen-axiom --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
What it does
Provides a reference guide for Core Spotlight and NSUserActivity, detailing how to index content, enable search predictions, support Handoff, and connect with App Intents entities. It covers creating searchable items, attribute sets, batch indexing, deletion strategies, and continuation from Spotlight results.
How it works
- Describes using Core Spotlight (CSSearchableItem) to index items with a uniqueIdentifier, domainIdentifier, and an attributeSet containing metadata like title, displayName, contentDescription, keywords, thumbnailData, and optional location and rating.
- Illustrates batch indexing with a recommended size range and contrasts with per-item indexing.
- Shows deletion patterns by identifier, domain, or deleting all items.
- Explains App Entity Integration (App Intents) by creating a CSSearchableItem from an AppEntity/IndexedEntity and indexing it, plus associating existing items to an entity.
- Details NSUserActivity usage for Handoff, Spotlight, Siri predictions, and quick notes, including enabling search/prediction, providing a persistentIdentifier, and attaching a CSSearchableItemAttributeSet as contentAttributeSet.
- Provides patterns for becomingCurrent and resigning activities in UIKit and SwiftUI, and demonstrates appEntityIdentifier linkage for surface in shortcuts and entities.
- Describes on-screen content tagging to help Spotlight parameter suggestions and activity continuation handling for UIKit, SwiftUI, and searchable item continuations.
- Includes deletion of saved user activities and continuation handlers for CSSearchableItem actions.
When to use it
Use this skill when you need:
- Indexing app content for Spotlight search
- Using NSUserActivity for Handoff or Siri predictions
- Choosing between CSSearchableItem, IndexedEntity, and NSUserActivity
- Activity continuation from Spotlight results
- Batch indexing for performance
- Deleting indexed content
- Integrating NSUserActivity with App Intents (appEntityIdentifier)
What it can touch
- Core Spotlight APIs (CSSearchableItem, CSSearchableIndex, CSSearchableItemAttributeSet)
- NSUserActivity and its properties (isEligibleForSearch, isEligibleForPrediction, isEligibleForHandoff, isEligibleForPublicIndexing, persistentIdentifier, contentAttributeSet, becomeCurrent, resignCurrent)
- App Intents (IndexedEntity, AppEntity, CSSearchableItem(appEntity:), associateAppEntity)
- CSSearchableItemActionType and relevant identifiers used in continuation handling
Caveats
- Platform support notes specify iOS 8+/iPadOS 8+/macOS 10.10+ for NSUserActivity features and iOS 9+ related Spotlight capabilities (as implied by description).
- Privacy: isEligibleForPublicIndexing should be true only for publicly accessible content.
- Maintain strong references to NSUserActivity instances to ensure visibility in search.
- Predictions and shortcuts integration rely on correct appEntityIdentifier linkage.
# Core Spotlight & NSUserActivity Reference ## Overview Comprehensive guide to Core Spotlight framework and NSUserActivity for making app content discoverable in Spotlight search, enabling Siri predictions, and supporting Handoff. Core Spotlight directly indexes app content while NSUserActivity captures user engagement for prediction. **Key distinction** Core Spotlight = indexing all app content; NSUserActivity = marking current user activity for prediction/handoff. --- ## When to Use This Skill Use this skill when: - Indexing app content (documents, notes, orders, messages) for Spotlight - Using NSUserActivity for Handoff or Siri predictions - Choosing between CSSearchableItem, IndexedEntity, and NSUserActivity - Implementing activity continuation from Spotlight results - Batch indexing for performance - Deleting indexed content - Debugging Spotlight search not finding app content - Integrating NSUserActivity with App Intents (appEntityIdentifier) Do NOT use this skill for: - App Shortcuts implementation (use app-shortcuts-ref) - App Intents basics (use app-intents-ref) - Overall discoverability strategy (use app-discoverability) --- ## Related Skills - **app-intents-ref** — App I
- Overview
- When to Use This Skill
- Related Skills
- When to Use Each API
- Core Spotlight (CSSearchableItem)
- Creating Searchable Items
- Key Properties
- CSSearchableItemAttributeSet
- Batch Indexing for Performance
- Deletion Patterns
- App Entity Integration (App Intents)
- NSUserActivity
- Eligibility Properties
- Basic Pattern
What does the axiom-core-spotlight-ref skill do?
Use when indexing app content for Spotlight search, using NSUserActivity for prediction/handoff, or choosing between CSSearchableItem and IndexedEntity - covers Core Spotlight framework and NSUserActivity integration for iOS 9+
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill axiom-core-spotlight-ref-charleswiltgen-axiom --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.