Skills inventory
Local Codex skills for Apple development — when to use each and what to avoid.
Source of truth: .agents/skills/manifest.json. The README table and router catalog are generated projections.
Inventory
Deep procedure lives in each skill’s SKILL.md — prefer reading that over forking long instructions into this site. Paths are relative to the foundation repository root.
| Skill | Path | Use for | Do not use for |
|---|---|---|---|
apple-development-foundation |
.agents/skills/apple-development-foundation/SKILL.md |
new iOS/macOS SwiftUI app bootstrap routing, reference-first child-skill selection, and explicitly requested foundation audits | replacing child instructions, implied audits or verification, claiming automatic activation, or generic non-foundation macOS/iOS work |
codex-bootstrap |
.agents/skills/codex-bootstrap/SKILL.md |
bootstrapping new iOS or macOS projects in the consumer workspace using these skills | one-off screens or editing archived package code in this repository |
apple-platform-planner |
.agents/skills/apple-platform-planner/SKILL.md |
planning an Apple-platform feature | implementation-only requests |
swiftui-tab-navigation |
.agents/skills/swiftui-tab-navigation/SKILL.md |
native app-level SwiftUI tabs and system Liquid Glass tab chrome | page-style tabs, segmented controls, or business-specific screens |
swiftui-component-author |
.agents/skills/swiftui-component-author/SKILL.md |
reusable SwiftUI components | app-specific screen copy |
apple-design-system |
.agents/skills/apple-design-system/SKILL.md |
design-system changes | application branding |
apple-app-marketing-site |
.agents/skills/apple-app-marketing-site/SKILL.md |
Apple app marketing sites (Astro + Tailwind): scaffold, polish, retheme, deploy | SwiftUI app UI, App Store screenshots, or general non-marketing web apps |
ios-macos-platform-adaptation |
.agents/skills/ios-macos-platform-adaptation/SKILL.md |
divergent platform behavior | shared identical behavior |
swift-package-module-author |
.agents/skills/swift-package-module-author/SKILL.md |
a reusable package target in the active workspace | an app-local feature or archived package work in this repository |
reusable-code-extractor |
.agents/skills/reusable-code-extractor/SKILL.md |
generalizing proven app code into consumer shared modules | speculative extraction or landing code in this repository’s archived package |
swift-concurrency-review |
.agents/skills/swift-concurrency-review/SKILL.md |
async/await and actor review | unrelated styling |
apple-accessibility-review |
.agents/skills/apple-accessibility-review/SKILL.md |
reusable UI accessibility | a non-UI service |
apple-security-privacy-review |
.agents/skills/apple-security-privacy-review/SKILL.md |
files, logging, permissions, and sensitive data | visual-only polish |
swift-testing-verification |
.agents/skills/swift-testing-verification/SKILL.md |
meaningful change verification | planning-only requests |
maestro-apple-app-testing |
.agents/skills/maestro-apple-app-testing/SKILL.md |
focused Maestro testing for Apple app journeys | non-testing product implementation |
codex-skill-maintainer |
.agents/skills/codex-skill-maintainer/SKILL.md |
skill changes | product code changes |
Start by task
| Task | Guide | Skill(s) |
|---|---|---|
| New app | Bootstrap | $apple-development-foundation → $codex-bootstrap (direct $codex-bootstrap only if already selected) |
| App-level tabs / Liquid Glass chrome | Task recipes · skill SKILL.md |
$swiftui-tab-navigation |
| Design tokens / shared components | Task recipes | $apple-design-system → $swiftui-component-author |
| iOS vs macOS divergence | Task recipes | $ios-macos-platform-adaptation |
| New SPM module / extract shared code | Task recipes | $swift-package-module-author / $reusable-code-extractor |
| Reviews | Reviews and quality | concurrency / security / a11y skills |
| Tests / UI | Testing | $swift-testing-verification · $maestro-apple-app-testing |
| Maintain skills | Authoring skills | $codex-skill-maintainer |
| Full scenario matrix | Task recipes | — |
Install and verify
./Scripts/install-skills.sh
./Scripts/verify-skills.shDetails: Scripts · Troubleshooting.
External skills
Not in this inventory: $app-store-screenshots and host-provided tools skills. See External skills.