app-shortcuts-ref

Configure AppShortcutsProvider with phrases and dynamic updates for iOS 16+.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This reference covers App Shortcuts for instant Siri/Spotlight availability, including provider setup and dynamic updates.

Core Features & Use Cases

  • AppShortcutsProvider definition and builder patterns
  • Phrases, dynamic updates, and negative phrases for shortcuts
  • Guidance on Instant Shortcuts vs App Intents

Quick Start

Prompt: "Define a set of instant shortcuts for frequent app actions."

Frequently Asked Questions about app-shortcuts-ref

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

FAQPage Schema
How do I make app actions available instantly in Siri and Spotlight?

App Shortcuts provide instant Siri and Spotlight availability for frequent actions. Set up an AppShortcutsProvider, define phrases, and configure instant Spotlight exposure. This works on iOS 16+ without requiring users to add shortcuts manually.

What's the difference between App Shortcuts and App Intents?

App Shortcuts surface predefined actions instantly in Siri and Spotlight with minimal user setup. App Intents offer broader automation integration. Choose Shortcuts for frequent, discoverable actions; choose Intents for full Shortcuts app builder support and complex parameters.

How do I set up AppShortcutsProvider with suggested phrases?

Implement AppShortcutsProvider using builder patterns to define shortcuts, assign suggested phrases for voice discovery, and enable instant Spotlight availability. Use parameterized phrases to customize actions per user context and update them dynamically via updateAppShortcutParameters().

Why aren't my app shortcuts appearing in Spotlight?

Verify instant Spotlight is configured in your AppShortcutsProvider setup. Check that phrases are valid and the app targets iOS 16+. Use debugging techniques to confirm the provider is registered and shortcuts meet Spotlight exposure requirements.

Can I use negative phrases to exclude certain shortcuts from suggestions?

Yes, NegativeAppShortcutPhrase is supported on iOS 17+. Use negative phrases to prevent Siri from suggesting irrelevant shortcuts, improving voice discovery accuracy and user experience with filtered shortcut recommendations.

How do I dynamically update shortcuts after the app launches?

Call updateAppShortcutParameters() to modify shortcuts dynamically after initial configuration. This lets you adjust phrases, parameters, and availability based on app state, user preferences, or context changes without requiring a restart.