Skip to content

dpearson2699/swift-ios-skills / skills/app-intents

app-intents

Verified

Implement App Intents for Siri, Shortcuts, Spotlight, widgets, Control Center, and Apple Intelligence on iOS. Covers AppIntent actions, AppEntity and EntityQuery models, AppShortcutsProvider phrases, IndexedEntity Spotlight indexing, WidgetConfigurationIntent, SnippetIntent, and assistant schemas. Use when exposing app actions or entities to system surfaces.

FileKindSize
SKILL.mdskill md16.4 KB
evals/evals.jsonconfig8.6 KB
references/appintents-advanced.mdmarkdown35.0 KB
references/system-surfaces.mdmarkdown6.4 KB

evals/evals.json

View on GitHub
{
  "skill_name": "app-intents",
  "evals": [
    {
      "id": 0,
      "name": "spotlight-indexed-entity-review",
      "prompt": "Review this App Intents Spotlight plan for an iOS 26 recipe app. We will conform RecipeEntity to IndexedEntity, put title and summary into attributeSet, call CSSearchableIndex.default().indexAppEntities from app launch, and also keep our old CSSearchableItem indexing path for the same recipes. What should we change before implementation?",
      "expected_output": "A correction-focused review that uses current App Intents and Core Spotlight guidance for IndexedEntity, indexing keys, named indexes, default attributes, duplicate indexing, and opening search results.",
      "files": [],
      "expectations": [
        "Recommends `@Property(indexingKey:)` or `@ComputedProperty(indexingKey:)` with key paths for entity metadata that is already exposed on the AppEntity.",
        "Says app entities still need to be indexed with `CSSearchableIndex(name: ...).indexAppEntities(...)` and recommends a named index rather than the default index for production.",
        "Warns that a custom `attributeSet` replaces the default attribute set unless `defaultAttributeSet` contents are included.",
        "Avoids duplicate search results by recommending `associateAppEntity(_:priority:)` when the app already indexes matching `CSSearchableItem` values.",
        "Mentions providing an `OpenIntent` for indexed entity types so Spotlight results can open the right app content."
      ]
    },
    {
      "id": 1,
      "name": "visual-intelligence-value-query",
      "prompt": "I need to expose my shopping app to Visual Intelligence on iOS 26. Sketch the App Intents pieces for returning matching ProductEntity and StoreEntity results from onscreen/camera input, and call out the main API constraints so another engineer does not create two competing visual queries.",
      "expected_output": "An implementation outline that models Visual Intelligence with IntentValueQuery, SemanticContentDescriptor, AppEntity results, optional UnionValue, and handoff/opening behavior.",
      "files": [],
      "expectations": [
        "Uses `IntentValueQuery.values(for input: SemanticContentDescriptor)` for Visual Intelligence matching.",
        "Uses `input.pixelBuffer` and/or descriptor labels appropriately, and keeps matching work quick and bounded.",
        "States that only one `IntentValueQuery` can take `SemanticContentDescriptor` and recommends `@UnionValue` when one query must return multiple AppEntity result types.",
        "Requires returned results to be AppEntity-compatible types with stable identifiers and display representations.",
        "Mentions providing an `OpenIntent` or equivalent opening path for selected results."
      ]
    },
    {
      "id": 2,
      "name": "widget-control-boundary",
      "prompt": "We are adding a configurable widget, a Control Center toggle, and an interactive Siri snippet for a smart-home app. Write the App Intents review checklist for which protocols belong to each surface and the pitfalls around optional parameters, snippets, and shared actions.",
      "expected_output": "A boundary-aware checklist that distinguishes WidgetConfigurationIntent, ControlConfigurationIntent, action AppIntent, and SnippetIntent responsibilities without drifting into WidgetKit layout detail.",
      "files": [],
      "expectations": [
        "Uses `WidgetConfigurationIntent` for configurable widget parameters and `ControlConfigurationIntent` for Control Center or Lock Screen control configuration.",
        "States that a `ControlConfigurationIntent` parameter without a default value must be optional so the system can preview the control before configuration.",
        "Separates reusable action intents from configuration intents, uses `SetValueIntent` with the system-supplied Boolean `value` for the toggle, and notes that configuration intents do not need `perform()` unless reused as actions.",
        "Mentions that `SnippetIntent.perform()` may run multiple times and should avoid side effects while rendering snippet state.",
        "Keeps detailed WidgetKit layout/timeline architecture outside the App Intents checklist except where it affects protocol choice."
      ]
    },
    {
      "id": 3,
      "name": "action-first-inline-handoff-design",
      "prompt": "We have a grocery app with Browse, Cart, and Checkout screens. Design the first App Intents we should ship. Users often add a previous item again, check the current cart total, and resume a checkout that needs payment confirmation. Explain which actions should finish inline versus open the app, and how to avoid duplicating business logic or navigation side effects.",
      "expected_output": "An action-first App Intents design that starts from high-value work outside the app, chooses a justified inline confirmation/authentication flow or a specific checkout handoff for payment based on security, required UI, provider constraints, and completion semantics, shares domain services, and centralizes the execution boundary before selecting protocols or system surfaces.",
      "files": [],
      "expectations": [
        "Selects a small set of user actions rather than mapping the Browse, Cart, and Checkout screen hierarchy directly to intents.",
        "Treats adding a previous item and checking the cart total as candidates for inline completion or results when authentication and confirmation requirements allow.",
        "Justifies the payment boundary: accepts either supported inline confirmation/authentication when payment can complete safely without required provider UI, or an app handoff to a specific checkout destination when UI or provider constraints require it, and explains completion semantics.",
        "Keeps cart mutation and lookup logic in shared domain services used by both the app and intent variants.",
        "Uses one explicit execution boundary and, when handoff is chosen, one runtime route or destination instead of placing ad hoc navigation side effects in each intent.",
        "Chooses App Intent protocols and system surfaces after defining the action and execution boundary."
      ]
    },
    {
      "id": 4,
      "name": "dependent-entity-options",
      "prompt": "A configurable project widget has Workspace and Project AppEntity parameters. Project choices must be limited to the selected workspace, and the current workspace's recent project may be suggested as a default. Design the EntityQuery behavior, including what happens before Workspace has a value.",
      "expected_output": "A current App Intents design using IntentParameterDependency in the project query, deliberately handling a missing upstream workspace, resolving identifiers correctly, and implementing defaultResult only for a stable useful recent-project default.",
      "files": [],
      "expectations": [
        "Uses `@IntentParameterDependency` in the project query or options provider to read the workspace parameter.",
        "Handles the dependency being nil before Workspace is configured instead of force-unwrapping it.",
        "Scopes suggested project entities to the selected workspace while keeping identifier resolution correct.",
        "Uses `defaultResult()` only for a genuinely useful stable default and does not choose an arbitrary first result.",
        "States the iOS 17+ availability of `IntentParameterDependency`."
      ]
    },
    {
      "id": 5,
      "name": "fixed-size-entity-array",
      "prompt": "An iOS 26 widget configuration must let a person select exactly three FavoriteEntity values. A review says every App Intents entity-array size initializer is deprecated, so the parameter should be an unconstrained array and reject the count only in perform(). Correct the design.",
      "expected_output": "A current App Intents parameter that uses the supported iOS 18+ size overload to express the three-item UI constraint and also validates the count at execution, while distinguishing deprecated iOS 17 overloads from their replacements.",
      "files": [],
      "expectations": [
        "Uses the current `@Parameter(..., size: .init(exactly: 3))` form, or an equivalent `IntentCollectionSize`, for the fixed-size entity array.",
        "Explains that Apple deprecated older iOS 17 overloads but provides supported iOS 18+ replacements with `size:`.",
        "Keeps a count check in `perform()` as execution-boundary validation instead of relying only on system UI.",
        "Does not replace a required fixed cardinality with an unconstrained array.",
        "Uses a range with `IntentCollectionSize(min:max:)` only when the product requirement is actually bounded rather than exact."
      ]
    }
  ]
}
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall