Skip to content
Back to search

swiftui-skills

Agent skills for SwiftUI, built from Apple's Xcode AI documentation.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ameyalambat128--swiftui-skills/badge.svg)](/listings/ameyalambat128--swiftui-skills)

HTML

<a href="/listings/ameyalambat128--swiftui-skills"><img src="/api/listings/ameyalambat128--swiftui-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

Installation differs a bit by harness. If you use more than one, keep the shared payload the same and choose the install surface that fits that tool.

Direct install (Recommended)

curl -fsSL https://swiftui-skills.ameyalambat.com/install | bash

The installer extracts local Xcode docs and installs the skill into detected runtimes, including OpenClaw shared installs at `~/.openclaw/skills/swiftui-skills`.

You can also use the skills TUI:

npx skills add ameyalambat128/swiftui-skills

Choose the install scope in the `skills` TUI and keep `Symlink (Recommended)` selected.

Shared agent install

~/.agents/skills/swiftui-skills/setup.sh

Project-local agent install

./.agents/skills/swiftui-skills/setup.sh

Claude Code

This repo ships a native Claude Code plugin manifest at `./.claude-plugin/plugin.json`.

For local plugin testing, symlink the repo into a Claude skills directory and start a new session:

ln -s /absolute/path/to/swiftui-skills ~/.claude/skills/swiftui-skills-plugin

Cursor

This repo ships a native Cursor plugin manifest at `./.cursor-plugin/plugin.json`.

For local plugin testing, symlink the repo into Cursor's local plugins directory and reload the window:

mkdir -p ~/.cursor/plugins/local
ln -s /absolute/path/to/swiftui-skills ~/.cursor/plugins/local/swiftui-skills

Codex

This repo ships a native Codex plugin manifest at `./.codex-plugin/plugin.json`.

Codex plugin packaging is included here so the repo is plugin-ready, but marketplace distribution is still optional. The direct skill install remains the simpler path today.

OpenClaw manual install

OpenClaw can load the same canonical skill package from any of these paths:

- `~/.agents/skills/swiftui-skills` - `~/.openclaw/skills/swiftui-skills` - `<workspace>/skills/swiftui-skills`

For a shared OpenClaw install:

mkdir -p ~/.openclaw/skills
cp -R skills/swiftui-skills ~/.openclaw/skills/swiftui-skills
~/.openclaw/skills/swiftui-skills/setup.sh

For a workspace-local OpenClaw install:

mkdir -p ./skills
cp -R skills/swiftui-skills ./skills/swiftui-skills
./skills/swiftui-skills/setup.sh

After setup, start a new OpenClaw session or restart the gateway.

Requirements

- macOS - Xcode 26 or later

Custom paths

If Xcode is installed in a non-standard location:

# Custom Xcode location
bash src/scripts/install.sh --xcode-path /Applications/Xcode-beta.app

# Direct path to docs folder
bash src/scripts/install.sh --docs-path /path/to/AdditionalDocumentation

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 246 lines · 1 finding marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # /swiftui-skills
  2. Apple-authored SwiftUI and Apple platform guidance, packaged as skills for AI coding agents.
  3. ## What is this?
  4. SwiftUI is opinionated. Most AI agents do not know those opinions.
  5. `/swiftui-skills` extracts internal Apple documentation shipped inside Xcode and turns it into reusable skills that help AI agents write idiomatic, Apple-native SwiftUI code.
  6. - Uses Apple-written guidance from inside Xcode
  7. - Reduces hallucinated or non-idiomatic SwiftUI
  8. - Works with Claude Code, Cursor, Codex, OpenClaw, and similar tools
  9. - Ships native plugin manifests for Claude Code, Cursor, and Codex
  10. - Open source and local-first
  11. ## Installation
  12. Installation differs a bit by harness. If you use more than one, keep the
  13. shared payload the same and choose the install surface that fits that tool.
  14. ### Direct install (Recommended)
  15. ```bash
  16. curl -fsSL https://swiftui-skills.ameyalambat.com/install | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 25 on GitHub
  17. ```
  18. The installer extracts local Xcode docs and installs the skill into detected runtimes, including OpenClaw shared installs at `~/.openclaw/skills/swiftui-skills`.
  19. You can also use the skills TUI:
  20. ```bash
  21. npx skills add ameyalambat128/swiftui-skills
  22. ```
  23. Choose the install scope in the `skills` TUI and keep `Symlink (Recommended)` selected.
  24. #### Shared agent install
  25. ```bash
  26. ~/.agents/skills/swiftui-skills/setup.sh
  27. ```
  28. #### Project-local agent install
  29. ```bash
  30. ./.agents/skills/swiftui-skills/setup.sh
  31. ```
  32. ### Claude Code
  33. This repo ships a native Claude Code plugin manifest at `./.claude-plugin/plugin.json`.
  34. For local plugin testing, symlink the repo into a Claude skills directory and start a new session:
  35. ```bash
  36. ln -s /absolute/path/to/swiftui-skills ~/.claude/skills/swiftui-skills-plugin
  37. ```
  38. ### Cursor
  39. This repo ships a native Cursor plugin manifest at `./.cursor-plugin/plugin.json`.
  40. For local plugin testing, symlink the repo into Cursor's local plugins directory and reload the window:
  41. ```bash
  42. mkdir -p ~/.cursor/plugins/local
  43. ln -s /absolute/path/to/swiftui-skills ~/.cursor/plugins/local/swiftui-skills
  44. ```
  45. ### Codex
  46. This repo ships a native Codex plugin manifest at `./.codex-plugin/plugin.json`.
  47. Codex plugin packaging is included here so the repo is plugin-ready, but marketplace distribution is still optional. The direct skill install remains the simpler path today.
  48. ### OpenClaw manual install
  49. OpenClaw can load the same canonical skill package from any of these paths:
  50. - `~/.agents/skills/swiftui-skills`
  51. - `~/.openclaw/skills/swiftui-skills`
  52. - `<workspace>/skills/swiftui-skills`
  53. For a shared OpenClaw install:
  54. ```bash
  55. mkdir -p ~/.openclaw/skills
  56. cp -R skills/swiftui-skills ~/.openclaw/skills/swiftui-skills
  57. ~/.openclaw/skills/swiftui-skills/setup.sh
  58. ```
  59. For a workspace-local OpenClaw install:
  60. ```bash
  61. mkdir -p ./skills
  62. cp -R skills/swiftui-skills ./skills/swiftui-skills
  63. ./skills/swiftui-skills/setup.sh
  64. ```
  65. After setup, start a new OpenClaw session or restart the gateway.
  66. ### Requirements
  67. - macOS
  68. - Xcode 26 or later
  69. ### Custom paths
  70. If Xcode is installed in a non-standard location:
  71. ```bash
  72. # Custom Xcode location
  73. bash src/scripts/install.sh --xcode-path /Applications/Xcode-beta.app
  74. # Direct path to docs folder
  75. bash src/scripts/install.sh --docs-path /path/to/AdditionalDocumentation
  76. ```
  77. ## How it works
  78. 1. The installer extracts Apple documentation from your local Xcode install.
  79. 2. The skill tells the agent how to use that documentation during generation and review.
  80. 3. Your agent uses the extracted docs as source of truth when writing SwiftUI code.
  81. No Apple documentation is redistributed. Everything is extracted locally during setup.
  82. ## What "supports OpenClaw" means
  83. This project is still a developer-focused SwiftUI skill.
  84. OpenClaw support means:
  85. - The canonical `SKILL.md` is compatible with OpenClaw skill loading.
  86. - The same skill package can live in OpenClaw-visible paths like `~/.agents/skills`, `~/.openclaw/skills`, or `<workspace>/skills`.
  87. - OpenClaw users get the same local-docs workflow after running `setup.sh`.
  88. - OpenClaw users can verify the skill with native commands like `openclaw skills list`.
  89. This does not add a plugin, split the package, or change the product into an OpenClaw-only tool.
  90. ## What's included
  91. Documentation extracted from Xcode covers:
  92. - SwiftUI patterns and composition
  93. - App Intents and system integrations
  94. - AlarmKit integration
  95. - StoreKit updates
  96. - WebKit + SwiftUI integration
  97. - SwiftData inheritance
  98. - Swift Concurrency updates
  99. - Liquid Glass design (SwiftUI, UIKit, AppKit, WidgetKit)
  100. - Widgets for visionOS
  101. - Low-level Swift performance primitives (InlineArray, Span)
  102. ## Usage
  103. ### Claude Code and similar agents
  104. The installer can place the skill directly into detected agent paths like `~/.claude/skills`, `~/.codex/skills`, and related runtimes.
  105. The repo root also carries native plugin manifests for Claude Code, Cursor, and Codex, while the canonical skill payload now lives at `skills/swiftui-skills/`.
  106. ### OpenClaw
  107. OpenClaw already loads visible skills from these paths, in precedence order:
  108. 1. `<workspace>/skills`
  109. 2. `<workspace>/.agents/skills`
  110. 3. `~/.agents/skills`
  111. 4. `~/.openclaw/skills`
  112. To verify the skill is visible:
  113. ```bash
  114. openclaw skills list
  115. ```
  116. Then start a new session and try a representative SwiftUI task:
  117. ```bash
  118. openclaw agent --message "Build a SwiftUI settings screen with a toolbar and explain which local docs you used."
  119. ```
  120. Expected smoke-test behavior:
  121. - The skill is listed by OpenClaw.
  122. - The agent references local extracted docs instead of inventing APIs.
  123. - If `docs/` is empty, the agent tells you to run `setup.sh` before proceeding.
  124. ## Project structure
  125. ```text
  126. swiftui-skills/
  127. ├── .claude-plugin/
  128. │ └── plugin.json # Claude Code plugin manifest
  129. ├── .codex-plugin/
  130. │ └── plugin.json # Codex plugin manifest
  131. ├── .cursor-plugin/
  132. │ └── plugin.json # Cursor plugin manifest
  133. ├── skills/
  134. │ └── swiftui-skills/ # Canonical shared skill payload
  135. │ ├── SKILL.md # Canonical skill contract
  136. │ ├── manifest.json # Tool compatibility helpers
  137. │ ├── prompts/ # System, router, reviewer, generator, refactorer
  138. │ ├── docs/ # Populated by setup
  139. │ └── setup.sh # Local Xcode docs extraction
  140. ├── src/
  141. │ ├── app/ # Next.js website
  142. │ └── scripts/
  143. │ ├── install.sh
  144. │ └── uninstall.sh
  145. └── public/
  146. └── install # curl target
  147. ```
  148. ## Uninstall
  149. ```bash
  150. bash src/scripts/uninstall.sh
  151. ```
  152. ## Who this is for
  153. - iOS developers refactoring into SwiftUI
  154. - Developers using AI to write SwiftUI-heavy apps
  155. - People working with App Intents, StoreKit, Widgets, or visionOS
  156. - Anyone tired of fighting non-idiomatic AI-generated SwiftUI
  157. ## Star History
  158. <a href="https://www.star-history.com/?repos=ameyalambat128%2Fswiftui-skills&type=date&legend=top-left">
  159. <picture>
  160. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=ameyalambat128/swiftui-skills&type=date&theme=dark&legend=top-left" />
  161. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=ameyalambat128/swiftui-skills&type=date&legend=top-left" />
  162. <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=ameyalambat128/swiftui-skills&type=date&legend=top-left" />
  163. </picture>
  164. </a>
  165. ## License
  166. MIT
  167. ## Author
  168. Built by [Ameya Lambat](https://ameyalambat.com). Not affiliated with Apple.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.