axiom-core-spotlight-ref

Indexes app content with Core Spotlight and NSUserActivity for search and predictions.

Updated Dec 23, 2025
One-click install
npx skills add https://github.com/pradeepmouli/swift-template --skill axiom-core-spotlight-ref-pradeepmouli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: axiom-core-spotlight-ref
Source: https://github.com/pradeepmouli/swift-template/tree/main/.agents/skills/axiom-core-spotlight-ref
Command: npx skills add https://github.com/pradeepmouli/swift-template --skill axiom-core-spotlight-ref-pradeepmouli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Comprehensive guidance for leveraging Core Spotlight and NSUserActivity to index app content, enable predictions, and manage user activities across platforms.

Core Features & Use Cases

  • Core Spotlight indexing with CSSearchableItem and domain/item attributes
  • NSUserActivity for Handoff, prediction, and Spotlight suggestions
  • App Intent integration via appEntityIdentifier for seamless discoverability
  • Example scenarios: indexing documents, syncing across devices, predicting user actions

Quick Start

Index a new item for Spotlight and create a corresponding NSUserActivity for the current screen.

Frequently Asked Questions about axiom-core-spotlight-ref

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I index app content for Spotlight search using CSSearchableItem?

Index app content for Spotlight by creating CSSearchableItem objects with domain and item attributes, then adding them to CSSearchableIndex. This enables iOS and macOS system-wide Spotlight search to locate and display your app's documents, notes, or data.

How does NSUserActivity work for Handoff and Spotlight suggestions?

NSUserActivity enables Handoff and Spotlight suggestions by tracking user actions with properties like isEligibleForHandoff and isEligibleForSearch. It syncs user activities across devices and surfaces relevant actions as predictions in Spotlight search results.

Can I integrate App Intents with Core Spotlight indexing?

Yes, you can integrate App Intents with Core Spotlight by using the appEntityIdentifier. This provides seamless discoverability, allowing indexed content to connect with App Intents for Siri predictions and Spotlight suggestions.

What's the best way to make app data searchable and sync activities across iOS and macOS?

The best way to make data searchable and sync activities is combining Core Spotlight and NSUserActivity. Use CSSearchableItem for indexing data and set NSUserActivity properties like isEligibleForPrediction to enable cross-device syncing and proactive suggestions.

Do I need NSUserActivity if I already use CSSearchableItem for indexing documents?

Yes, you need NSUserActivity alongside CSSearchableItem to enable full functionality. While CSSearchableItem indexes documents for Spotlight search, NSUserActivity is required for Handoff, predictive suggestions, and syncing the current screen state across devices.