app-discoverability

Implement iOS discovery APIs with App Intents, App Shortcuts, Core Spotlight, and NSUserActivity to publish metadata and index content for Spotlight and Siri suggestions.

1.1k|81|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/CharlesWiltgen/Axiom --skill app-discoverability
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: app-discoverability
Source: https://github.com/CharlesWiltgen/Axiom/tree/main/.claude-plugin/plugins/axiom/skills/app-discoverability
Command: npx skills add https://github.com/CharlesWiltgen/Axiom --skill app-discoverability

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides you in crafting a multi-API strategy for app discoverability across Spotlight, Siri, App Shortcuts, and App Intents to surface your app when users actually engage with it.

Core Features & Use Cases

  • Six-step strategy: App Intents, App Shortcuts, Core Spotlight, and NSUserActivity coordination.
  • Predictive surfacing: Leverage system learning to surface frequently used actions.
  • Roadmap planning: Architecture guidance before API-by-API implementation.

Quick Start

Draft a plan to surface your top 3 actions in Spotlight and suggest corresponding App Shortcuts and Intents.

Frequently Asked Questions about app-discoverability

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

FAQPage Schema
How do I improve app discoverability across Spotlight and Siri?

App discoverability improves by coordinating App Intents, App Shortcuts, Core Spotlight, and NSUserActivity to surface your app's actions in system search and suggestions. This 6-step strategy feeds metadata to iOS discovery APIs so users find your app when they need it.

What's the difference between App Intents, App Shortcuts, Core Spotlight, and NSUserActivity?

App Intents expose actionable functionality to Siri and system-wide experiences; App Shortcuts let users automate tasks; Core Spotlight indexes searchable content; NSUserActivity preserves user context for handoff and Siri suggestions. Together they create a complete discoverability strategy.

How do I surface my app's actions in Spotlight search?

Surface actions in Spotlight by indexing content with Core Spotlight and connecting App Intents to expose them as discoverable actions. NSUserActivity attributes link user context to make actions predictively surface when users engage with your app.

Can I connect App Intents with App Shortcuts for better discoverability?

Yes. App Intents designed for Siri can be directly connected to App Shortcuts, enabling users to automate frequently used actions while boosting surface exposure across Siri suggestions and system discoverability surfaces.

Do I need all four APIs—App Intents, Shortcuts, Core Spotlight, and NSUserActivity—or can I start with one?

You can start with one API, but the full 6-step strategy coordinates all four for maximum discoverability. Core Spotlight and NSUserActivity together cover indexing and context; App Intents and Shortcuts add automation and predictive surfacing.

How does predictive surfacing work in Spotlight and Siri?

Predictive surfacing uses NSUserActivity attributes and system learning to surface frequently accessed actions. By exposing your app's top actions through App Intents and indexing with Core Spotlight, the system learns what users engage with and surfaces those actions proactively.