app-intents-pro
Skill5 starsChanged 11 days agoMITView on GitHub
Writes and reviews App Intents for Shortcuts, Siri, Spotlight, widgets, and controls — perform() isolation and restarts, stable AppEntity ids and batched queries, AppEnum raw values, parameters and summaries, @Dependency registration, errors Siri can show, donation, App Shortcut phrases, the iOS 26/27 APIs (supportedModes, interactive snippets, schemas, Spotlight indexing, EntityCollection, AppIntentsTesting), and Siri's model in 27.3 (@AppIntent(.tool), generable entities, Skills.skillsbundle, sirimetadataanalyzer, SiriEvaluations). Use when writing, reviewing, or migrating App Intents code, or making an app work with Siri or Apple Intelligence.
In this repository19 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- coredata-swift6-proSkill
- instruments-profiling-proSkill
- motion-design-proSkill
- store-compliance-proSkill
- swift-accessibility-proSkill
- swift-adaptive-layout-proSkill
- swift-concurrency-proSkill
- swiftdata-proSkill
- swift-design-system-proSkill
- swift-docc-proSkill
- swift-error-handling-proSkill
- swift-logging-proSkill
- swift-memory-storage-proSkill
- swift-modularization-proSkill
- swift-package-proSkill
- swift-testing-proSkill
- swiftui-proSkill
- xcode-security-proSkill
The file
We split this skill into the rules it gives an agent
8 rules. About 0 are common, 2 are distinctive, and 6 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
6
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 11
Write and review App Intents code.
- Distinctive: line 15
If asked to write or fix rather than review, make the changes directly and summarize them in the same file-by-file format.
- Very specific: line 19
Check perform() isolation, restart safety, confirmation order, and result and error shapes using references/execution-and-results.md.
- Very specific: line 20
Check entity identity, queries, enums, and @Dependency placement using references/entities-and-queries.md.
- Very specific: line 21
Check parameters, parameter summaries, localization, donation, and App Shortcut phrases using references/parameters-and-shortcuts.md.
- Very specific: line 22
When the deployment target or SDK is 26 or later, or the code uses any newer API, check adoption and availability gating using …
- Very specific: line 23
When the task is Siri or Apple Intelligence (tools, generable entities, app skills for Siri), follow references/siri-integration.md.
- Distinctive: line 31
Public API only: Never emit underscore-prefixed or private symbols, and never invent a type, initializer, or parameter to make a snippet …
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Write and review App Intents code. This is the deep-review companion to the apple-app-intents.md rule: the rule steers while writing; this skill audits whole intent surfaces and drives Siri adoption. Report only genuine problems.
Sources. Grounded in Apple's App Intents documentation and in the App Intents, Siri app integration, and SiriEvaluations skills Apple bundles with Xcode 27, which Artem Novichkov extracted and published in
artemnovichkov/xcode-skills. The guidance is rewritten and condensed for this bundle, not copied. Check spellings and availability against the SDK you build with.
If asked to write or fix rather than review, make the changes directly and summarize them in the same file-by-file format.
Review process:
- Check
perform()isolation, restart safety, confirmation order, and result and error shapes usingreferences/execution-and-results.md. - Check entity identity, queries, enums, and
@Dependencyplacement usingreferences/entities-and-queries.md. - Check parameters, parameter summaries, localization, donation, and App Shortcut phrases using
references/parameters-and-shortcuts.md. - When the deployment target or SDK is 26 or later, or the code uses any newer API, check adoption and availability gating using
references/ios26-27-apis.md. - When the task is Siri or Apple Intelligence (tools, generable entities, app skills for Siri), follow
references/siri-integration.md. - For tests, use
references/testing-and-evaluation.md(AppIntentsTestingfor intents and queries,SiriEvaluationsfor how Siri uses them).
On a large codebase, list the intent surfaces first (each intent, entity and its query, enum, the AppShortcutsProvider) and review them one at a time. For a partial review, load only the matching reference.
Core Instructions
- Identifiers are a public contract. Saved shortcuts and donations replay an intent by its type name and store
AppEntity.ids andAppEnumraw values. App Shortcut phrases are a separate contract for voice. Adding is safe. Renaming or removing an intent type, changing an id scheme, renumbering an enum, or adding, removing, or renaming a parameter breaks users' shortcuts: flag it and never do it as a side effect. - Public API only. Never emit underscore-prefixed or private symbols, and never invent a type, initializer, or parameter to make a snippet compile. If a capability needs non-public API, say so.
- Gate by real availability. Tag each newer API with its true floor (the references list them) and gate with
@available/if #availablewhen the deployment target is lower. Don't drop the feature and don't misdate it. - Keep
perform()thin. It calls the app's existing model code and writes to the persisted store. An intent can run while the app isn't on screen, and the process can exit right after, so in-memory-only state is lost. - Severity by user impact: crash or data loss (unregistered
@Dependency, missingcaseDisplayRepresentationsentry, double-charge on restart, broken saved shortcuts) > broken surface (empty picker, untranslatable strings, generic error message, dropped phrase) > polish (missing search keywords, weak descriptions). - Cross-reference, don't duplicate: actor isolation belongs to
swift-concurrency-pro; error type design toswift-error-handling-pro; String Catalog structure to theapple-localization-best-practices.mdrule; Swift Testing style toswift-testing-pro.
Output Format
Organize findings by file. For each issue: file and line, the violated principle, the user-visible consequence, and a brief before/after. Skip clean files. End with a prioritized summary.
Example finding:
LogWorkoutIntent.swift
Line 31: the charge runs before needsValueError, so a missing value restarts perform() and charges twice.
// Before
try await billing.charge(plan)
guard let card else { throw $card.needsValueError("Which card?") }
// After
guard let card else { throw $card.needsValueError("Which card?") }
try await billing.charge(plan, to: card)Summary
- Crash or data loss:
RecipeQueryreads an unregistered@Dependencyon a cold Siri launch. - Broken surface:
MealKindhas no display entry for.brunch; Shortcuts traps when it shows the case. - Polish: two App Shortcuts lack
shortTitleandsystemImageName.
End of example.
References
references/execution-and-results.md—perform()isolation, restarts and idempotency, confirmation,.result(...)shapes, errors Siri and Shortcuts can show.references/entities-and-queries.md— stable ids,@Propertyvisibility,entities(for:)vssuggestedEntities(), string and property queries,EnumerableEntityQuerylimits,AppEnumpersistence,@Dependencyregistration and placement.references/parameters-and-shortcuts.md—requestValuevsneedsValueError, enum disambiguation,@IntentParameterDependency, parameter summaries, localization, donation, App Shortcut phrases, URL and configuration intents.references/ios26-27-apis.md—supportedModes, foreground continuation, undo, cancel, long-running intents, execution targets, interactive snippets,requestChoice, schemas, Visual Intelligence, onscreen entities, Spotlight indexing, relevant entities, syncable and ownership-aware entities,EntityCollection, union values.references/siri-integration.md— making an app work with Siri's model in 27.3: adoption order,@AppIntent(.tool), metadata the model reads, generable entities, property descriptions and.internal, the app'sSkills.skillsbundle,sirimetadataanalyzer.references/testing-and-evaluation.md—AppIntentsTesting(out-of-process intent and query tests) andSiriEvaluations(scenarios that grade how Siri picks and fills intents).
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

