[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CGCWSY21JYR0RVG685S490":3,"skill-same:01M7CGCWSY21JYR0RVG685S490":67},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M7CGCWSY21JYR0RVG685S490","ios-app-intents",null,"Design App Intents, app entities, and App Shortcuts for iOS system surfaces. Use when exposing app actions or content to Shortcuts, Siri, Spotlight, widgets, or controls.","rossboyd\u002Fquickque","rossboyd","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F3195729?v=4","01M7CG99NTNRFV0TWTZX9JY9CQ","rbyd","01M7CG99PH4WEP5P45VTBNPDB0",0,"MIT","https:\u002F\u002Fgithub.com\u002Frossboyd\u002Fquickque\u002Fblob\u002Fmain\u002F.codex\u002F.tmp\u002Fplugins\u002Fplugins\u002Fbuild-ios-apps\u002Fskills\u002Fios-app-intents\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: ios-app-intents\ndescription: Design App Intents, app entities, and App Shortcuts for iOS system surfaces. Use when exposing app actions or content to Shortcuts, Siri, Spotlight, widgets, or controls.\n---\n\n# iOS App Intents\n\n## Overview\nExpose the smallest useful action and entity surface to the system. Start with the verbs and objects people would actually want outside the app, then implement a narrow App Intents layer that can deep-link or hand off cleanly into the main app when needed.\n\nRead these references as needed:\n\n- `references\u002Ffirst-pass-checklist.md` for choosing the first intent and entity surface\n- `references\u002Fexample-patterns.md` for concrete example shapes to copy and adapt\n- `references\u002Fcode-templates.md` for generalized App Intents code templates\n- `references\u002Fsystem-surfaces.md` for how to think about Shortcuts, Siri, Spotlight, widgets, and other system entry points\n\n## Core workflow\n\n### 1) Start with actions, not screens\n- Identify the 1-3 highest-value actions that should work outside the app UI.\n- Prefer verbs like compose, open, find, filter, continue, inspect, or start.\n- Do not mirror the entire app navigation tree as intents.\n\n### 2) Define a small entity surface\n- Add `AppEntity` types only for the objects the system needs to understand or route.\n- Keep the entity shape narrower than the app's persistence model.\n- Add `EntityQuery` or other query types only where disambiguation or suggestions are genuinely useful.\n\n### 3) Decide whether the action completes in place or opens the app\n- Use non-opening intents for actions that can complete directly from the system surface.\n- Use `openAppWhenRun` or open-style intents when the user should land in a specific in-app workflow.\n- When the app must react inside the main scene, add one clear runtime handoff path instead of scattering ad hoc routing logic.\n- If the action can work in both modes, consider shipping both an inline version and an open-app version rather than forcing one compromise.\n\n### 4) Make the actions discoverable\n- Add `AppShortcutsProvider` entries for the first set of high-value intents.\n- Choose titles, phrases, and symbols that make sense in Shortcuts, Siri, and Spotlight.\n- Keep shortcut phrases direct and task-oriented.\n- Reuse the same action model for widgets and controls when a widget configuration or intent-driven control already needs the same parameters.\n\n### 5) Validate the runtime handoff\n- Build the app and confirm the intents target compiles cleanly.\n- Verify the app opens or routes to the expected place when an intent runs.\n- Summarize which actions are now exposed, which entities back them, and how the app handles invocation.\n\n## Strong defaults\n\n- Prefer a dedicated intents target or module for the system-facing layer.\n- Keep intent types thin; business logic should stay in app services or domain models.\n- Keep app entities small and display-friendly.\n- Use `AppEnum` for fixed app choices such as tabs, modes, or visibility levels before reaching for a full entity type.\n- Prefer one predictable app-intent routing surface in the main app scene or root router.\n- Treat App Intents as system integration infrastructure, not only as a Shortcuts feature.\n\n## Anti-patterns\n\n- Exposing every screen or tab as its own intent without a real user value.\n- Mirroring the entire model graph as `AppEntity` types.\n- Hiding runtime handoff in global side effects with no clear app entry path.\n- Adding App Shortcuts with vague phrases or generic titles.\n- Treating the first App Intents pass as a broad taxonomy project instead of a small useful release.\n\n## Notes\n\n- Apple documentation to use as primary references:\n  - `https:\u002F\u002Fdeveloper.apple.com\u002Fdocumentation\u002Fappintents\u002Fmaking-actions-and-content-discoverable-and-widely-available`\n  - `https:\u002F\u002Fdeveloper.apple.com\u002Fdocumentation\u002Fappintents\u002Fcreating-your-first-app-intent`\n  - `https:\u002F\u002Fdeveloper.apple.com\u002Fdocumentation\u002Fappintents\u002Fadopting-app-intents-to-support-system-experiences`\n- In addition to the links above, use web search to consult current Apple Developer documentation when App Intents APIs or platform behavior may have changed.\n- A good first pass often includes one open-app intent, one action intent, one or two entity types, and a small `AppShortcutsProvider`.\n- Good example families to cover are:\n  - open a destination or editor in the app\n  - perform a lightweight action inline without opening the app\n  - choose from a fixed enum such as a tab or mode\n  - resolve one or more entities through `EntityQuery`\n  - power widget configuration or controls from the same entity surface\n","# iOS App Intents\n\n## Overview\nExpose the smallest useful action and entity surface to the system. Start with the verbs and objects people would actually want outside the app, then implement a narrow App Intents layer that can deep-link or hand off cleanly into the main app when needed.\n\nRead these references as needed:\n\n- `references\u002Ffirst-pass-checklist.md` for choosing the first intent and entity surface\n- `references\u002Fexample-patterns.md` for concrete example shapes to copy and adapt\n- `references\u002Fcode-templates.md` for generalized App Intents code templates\n- `references\u002Fsystem-surfaces.md` for how to think about Shortcuts, Siri, Spotlight, widgets, and other system entry points\n\n## Core workflow\n\n### 1) Start with actions, not screens\n- Identify the 1-3 highest-value actions that should work outside the app UI.\n- Prefer verbs like compose, open, find, filter, continue, inspect, or start.\n- Do not mirror the entire app navigation tree as intents.\n\n### 2) Define a small entity surface\n- Add `AppEntity` types only for the objects the system needs to understand or route.\n- Keep the entity shape narrower than the app's persistence model.\n- Add `EntityQuery` or other query types only where disambiguation or suggestions are genuinely useful.\n\n### 3) Decide whether the action completes in place or opens the app\n- Use non-opening intents for actions that can complete directly from the system surface.\n- Use `openAppWhenRun` or open-style intents when the user should land in a specific in-app workflow.\n- When the app must react inside the main scene, add one clear runtime handoff path instead of scattering ad hoc routing logic.\n- If the action can work in both modes, consider shipping both an inline version and an open-app version rather than forcing one compromise.\n\n### 4) Make the actions discoverable\n- Add `AppShortcutsProvider` entries for the first set of high-value intents.\n- Choose titles, phrases, and symbols that make sense in Shortcuts, Siri, and Spotlight.\n- Keep shortcut phrases direct and task-oriented.\n- Reuse the same action model for widgets and controls when a widget configuration or intent-driven control already needs the same parameters.\n\n### 5) Validate the runtime handoff\n- Build the app and confirm the intents target compiles cleanly.\n- Verify the app opens or routes to the expected place when an intent runs.\n- Summarize which actions are now exposed, which entities back them, and how the app handles invocation.\n\n## Strong defaults\n\n- Prefer a dedicated intents target or module for the system-facing layer.\n- Keep intent types thin; business logic should stay in app services or domain models.\n- Keep app entities small and display-friendly.\n- Use `AppEnum` for fixed app choices such as tabs, modes, or visibility levels before reaching for a full entity type.\n- Prefer one predictable app-intent routing surface in the main app scene or root router.\n- Treat App Intents as system integration infrastructure, not only as a Shortcuts feature.\n\n## Anti-patterns\n\n- Exposing every screen or tab as its own intent without a real user value.\n- Mirroring the entire model graph as `AppEntity` types.\n- Hiding runtime handoff in global side effects with no clear app entry path.\n- Adding App Shortcuts with vague phrases or generic titles.\n- Treating the first App Intents pass as a broad taxonomy project instead of a small useful release.\n\n## Notes\n\n- Apple documentation to use as primary references:\n  - `https:\u002F\u002Fdeveloper.apple.com\u002Fdocumentation\u002Fappintents\u002Fmaking-actions-and-content-discoverable-and-widely-available`\n  - `https:\u002F\u002Fdeveloper.apple.com\u002Fdocumentation\u002Fappintents\u002Fcreating-your-first-app-intent`\n  - `https:\u002F\u002Fdeveloper.apple.com\u002Fdocumentation\u002Fappintents\u002Fadopting-app-intents-to-support-system-experiences`\n- In addition to the links above, use web search to consult current Apple Developer documentation when App Intents APIs or platform behavior may have changed.\n- A good first pass often includes one open-app intent, one action intent, one or two entity types, and a small `AppShortcutsProvider`.\n- Good example families to cover are:\n  - open a destination or editor in the app\n  - perform a lightweight action inline without opening the app\n  - choose from a fixed enum such as a tab or mode\n  - resolve one or more entities through `EntityQuery`\n  - power widget configuration or controls from the same entity surface\n",{"name":5,"description":7},"main","907b1d897cc6743f7f133f8ea2021e1331b0b020",".codex\u002F.tmp\u002Fplugins\u002Fplugins\u002Fbuild-ios-apps\u002Fskills\u002Fios-app-intents","https:\u002F\u002Fgithub.com\u002Frossboyd\u002Fquickque","https:\u002F\u002Fgithub.com\u002Frossboyd","www.bigideasgroup.co.uk","2026-09-22 02:03:50",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add rossboyd\u002Fquickque --skill ios-app-intents",{"tool":37,"command":38},"bunx","bunx skills add rossboyd\u002Fquickque --skill ios-app-intents",{"tool":40,"command":41},"pnpm","pnpm dlx skills add rossboyd\u002Fquickque --skill ios-app-intents","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Frossboyd\u002Fquickque\u002Fblob\u002Fmain\u002F.codex\u002F.tmp\u002Fplugins\u002Fplugins\u002Fbuild-ios-apps\u002Fskills\u002Fios-app-intents\u002FSKILL.md",true,[45,51,55,59,63],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"agents\u002Fopenai.yaml","REFERENCE","参考文档",113,"https:\u002F\u002Fgithub.com\u002Frossboyd\u002Fquickque\u002Fblob\u002Fmain\u002F.codex\u002F.tmp\u002Fplugins\u002Fplugins\u002Fbuild-ios-apps\u002Fskills\u002Fios-app-intents\u002Fagents\u002Fopenai.yaml",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Fcode-templates.md",7575,"https:\u002F\u002Fgithub.com\u002Frossboyd\u002Fquickque\u002Fblob\u002Fmain\u002F.codex\u002F.tmp\u002Fplugins\u002Fplugins\u002Fbuild-ios-apps\u002Fskills\u002Fios-app-intents\u002Freferences\u002Fcode-templates.md",{"path":56,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":57,"sourceHtmlUrl":58},"references\u002Fexample-patterns.md",3712,"https:\u002F\u002Fgithub.com\u002Frossboyd\u002Fquickque\u002Fblob\u002Fmain\u002F.codex\u002F.tmp\u002Fplugins\u002Fplugins\u002Fbuild-ios-apps\u002Fskills\u002Fios-app-intents\u002Freferences\u002Fexample-patterns.md",{"path":60,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":61,"sourceHtmlUrl":62},"references\u002Ffirst-pass-checklist.md",1411,"https:\u002F\u002Fgithub.com\u002Frossboyd\u002Fquickque\u002Fblob\u002Fmain\u002F.codex\u002F.tmp\u002Fplugins\u002Fplugins\u002Fbuild-ios-apps\u002Fskills\u002Fios-app-intents\u002Freferences\u002Ffirst-pass-checklist.md",{"path":64,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":65,"sourceHtmlUrl":66},"references\u002Fsystem-surfaces.md",1059,"https:\u002F\u002Fgithub.com\u002Frossboyd\u002Fquickque\u002Fblob\u002Fmain\u002F.codex\u002F.tmp\u002Fplugins\u002Fplugins\u002Fbuild-ios-apps\u002Fskills\u002Fios-app-intents\u002Freferences\u002Fsystem-surfaces.md",[68,77,85,92,99,107],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":72,"licenseFileUrl":73,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7CJSS21K09H3ZQZMPFR4ZAG","skill-installer","Install Codex skills into $CODEX_HOME\u002Fskills from a curated list or a GitHub repo path. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo (including private repos).","Apache-2.0","https:\u002F\u002Fgithub.com\u002Frossboyd\u002Fquickque\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002F.system\u002Fskill-installer\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Frossboyd\u002Fquickque\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002F.system\u002Fskill-installer\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":72,"licenseFileUrl":81,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M7CJSM1F4E7RBXCS3C18EFBY","skill-creator","Create or update a Codex skill with appropriately scoped instructions and any needed supporting resources.","https:\u002F\u002Fgithub.com\u002Frossboyd\u002Fquickque\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002F.system\u002Fskill-creator\u002Flicense.txt","https:\u002F\u002Fgithub.com\u002Frossboyd\u002Fquickque\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002F.system\u002Fskill-creator\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M7CJSGF2PJM504Q6TZCNT27C","review-agent","Perform a read-only, defect-first review of a specified code change and return every actionable finding. Use when another agent delegates review of uncommitted changes, a base-branch diff, a commit, or custom review instructions.","https:\u002F\u002Fgithub.com\u002Frossboyd\u002Fquickque\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002F.system\u002Freview-agent\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M7CJSBQTPFEQYZF4VWS7QZ3N","plugin-creator","Create and scaffold plugin directories for Codex with a required `.codex-plugin\u002Fplugin.json`, optional plugin folders\u002Ffiles, valid manifest defaults, and personal-marketplace entries by default. Use when Codex needs to create a new personal plugin, add optional plugin structure, generate or update marketplace entries for plugin ordering and availability metadata, or update an existing local plugin during development with the CLI-driven cachebuster and reinstall flow.","https:\u002F\u002Fgithub.com\u002Frossboyd\u002Fquickque\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002F.system\u002Fplugin-creator\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":72,"licenseFileUrl":103,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":19},"01M7CJS5BHJZKA16353PVZGC50","openai-docs","Use for Codex models\u002Fpricing, scheduled tasks, skills, settings, setup, troubleshooting, customization, automations, and self-knowledge—including 'you,' 'your,' 'this app,' or 'this coding agent' when they refer to Codex—and for OpenAI APIs\u002Fproducts and ChatGPT Work. Also use for model choice\u002Fmigration, prompting, SDKs, Responses, Realtime, agents, evals, and Chat\u002FWork\u002FCodex comparisons. Do not use for generic app\u002Fsoftware tasks that merely mention Codex.","https:\u002F\u002Fgithub.com\u002Frossboyd\u002Fquickque\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002F.system\u002Fopenai-docs\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Frossboyd\u002Fquickque\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002F.system\u002Fopenai-docs\u002FSKILL.md",[],[],{"skillNo":108,"name":109,"nameZh":6,"description":110,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":72,"licenseFileUrl":111,"sourceHtmlUrl":112,"categories":113,"keywords":114,"publishedAt":19},"01M7CJRY1FC048P3RF4YQZ6J8B","imagegen","Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG\u002Fvector\u002Fcode-native assets, extending an established icon or logo system, or building the visual directly in HTML\u002FCSS\u002Fcanvas.","https:\u002F\u002Fgithub.com\u002Frossboyd\u002Fquickque\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002F.system\u002Fimagegen\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Frossboyd\u002Fquickque\u002Fblob\u002Fmain\u002F.codex\u002Fskills\u002F.system\u002Fimagegen\u002FSKILL.md",[],[]]