Skip to content
Back to search

emil-design-swiftui

MarketplaceWorks with Claude CodeGitHub

Emil Kowalski's design skills, adapted for SwiftUI. Unofficial; based on emilkowalski/skills (MIT).

Safety scan

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

Checked today

Check it deeper on your machine

It has changed since its scan on 21 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/OrenSegal/emil-design-swiftui with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/OrenSegal/emil-design-swiftui'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/orensegal--emil-design-swiftui/badge.svg)](/listings/orensegal--emil-design-swiftui)

HTML

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

Install

Install instructions from the README

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

npx skills@latest add OrenSegal/emil-design-swiftui

Or, in Claude Code, as a plugin:

claude plugin marketplace add OrenSegal/emil-design-swiftui
claude plugin install emil-design-swiftui@emil-design-swiftui

Or copy the folders in `skills/` into `~/.claude/skills/` (or a project's `.claude/skills/`).

The skills use the curves, springs and press style in [`Motion.swift`](Sources/EmilMotion/Motion.swift) by name. Add this repo as a Swift package (product `EmilMotion`, iOS 18 / macOS 15), or copy that file into your app target and drop its `public`s. `xcrun swift test` runs its tests.

The skill names match Emil's originals, so cross-references keep working. If you already have the web versions installed, install these into a project folder instead, or remove the web ones first.

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.

.claude-plugin/marketplace.json · Manifest · 14 lines
  1. {
  2. "name": "emil-design-swiftui",
  3. "owner": { "name": "Oren Segal" },
  4. "metadata": { "description": "Unofficial SwiftUI adaptation of Emil Kowalski's skills (emilkowalski/skills, MIT)." },
  5. "plugins": [
  6. {
  7. "name": "emil-design-swiftui",
  8. "source": "./",
  9. "description": "Unofficial SwiftUI adaptation of Emil Kowalski's design-engineering and animation skills for native iOS apps. Credit for the design judgment is Emil's; he did not write, review or endorse this port.",
  10. "version": "0.1.0",
  11. "license": "MIT"
  12. }
  13. ]
  14. }
README.md · README · 93 lines
  1. # Emil Kowalski's Skills, for SwiftUI
  2. [Emil Kowalski](https://emilkowal.ski)'s skills for designers and engineers, adapted for native iOS apps. The design judgment is his. What's new is the implementation: SwiftUI in place of CSS, Motion and React.
  3. This is an unofficial adaptation of [emilkowalski/skills](https://github.com/emilkowalski/skills). Emil did not write, review or endorse it.
  4. ## Credit
  5. These skills are Emil's work. He wrote them from his years of building interfaces at companies like Vercel and Linear, and they hold the small decisions that make an interface feel right: which curve, how fast, where the motion starts, and when to leave it out. Agents tend to get those decisions wrong, which he explains in [Agents with Taste](https://emilkowal.ski/ui/agents-with-taste).
  6. If these help you, go to the source:
  7. - Read the originals, with examples and prompts to try, at [aiforui.dev/skills](https://aiforui.dev/skills).
  8. - [Sign up to his newsletter](https://aiforui.dev/newsletter) for new skills.
  9. - For anything that runs in a browser, use his web skills: `npx skills@latest add emilkowalski/skills`.
  10. I'm [Oren Segal](https://github.com/OrenSegal), and I ported them to SwiftUI from upstream commit [`64eb3de`](https://github.com/emilkowalski/skills/tree/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c). Where this port departs from his rules, [CONVERSION.md](CONVERSION.md) and [FLAGGED.md](FLAGGED.md) say how and why. Any mistake in the SwiftUI is mine, not his, so please report it [here](https://github.com/OrenSegal/emil-design-swiftui/issues) rather than on his repo.
  11. ## What it is
  12. Emil's reasoning and his values carry over wherever the platform allows. A few rules needed a native reason or a native number, and those changes are listed below. The web implementation has been replaced with native SwiftUI. Rules that only exist because of the browser are not translated. They are listed in [FLAGGED.md](FLAGGED.md) and at the end of each skill, so you can see what was left out and why.
  13. Target: iOS 18 and Swift 6. APIs newer than iOS 18, like Liquid Glass, only appear behind `#available` with a fallback.
  14. ## Install
  15. ```bash
  16. npx skills@latest add OrenSegal/emil-design-swiftui
  17. ```
  18. Or, in Claude Code, as a plugin:
  19. ```bash
  20. claude plugin marketplace add OrenSegal/emil-design-swiftui
  21. claude plugin install emil-design-swiftui@emil-design-swiftui
  22. ```
  23. Or copy the folders in `skills/` into `~/.claude/skills/` (or a project's `.claude/skills/`).
  24. The skills use the curves, springs and press style in [`Motion.swift`](Sources/EmilMotion/Motion.swift) by name. Add this repo as a Swift package (product `EmilMotion`, iOS 18 / macOS 15), or copy that file into your app target and drop its `public`s. `xcrun swift test` runs its tests.
  25. The skill names match Emil's originals, so cross-references keep working. If you already have the web versions installed, install these into a project folder instead, or remove the web ones first.
  26. ## What changed from the web version
  27. - **Kept as is:** every rule about frequency, purpose, easing, duration, origin, interruption, asymmetry and restraint, with Emil's original values.
  28. - **One new rule:** leave system motion alone. Sheets, navigation pushes, menus and popovers already move the way iOS users expect, and they already respect Reduce Motion. Emil's curves are for the components you build.
  29. - **Reframed:** some rules hold but for a different reason natively. For example, an interrupted spring hands its velocity to the new target, so springs play the role CSS transitions play on the web. A timing curve keeps running and stacks with the new one, which is why curves are the wrong choice for anything the user can reverse. Sonner's swipe-to-dismiss threshold of 0.11 px/ms is an average over the whole drag, while SwiftUI reports the release velocity, so the native threshold is 500 pt/s. A small [probe app](Examples/README.md) confirms this on a simulator. [CONVERSION.md](CONVERSION.md) lists every mapping.
  30. - **Not ported:** `animate-expo` (React Native) and `ask-sonner` (a React library). The ideas from them that apply natively live in `animate`, `gestures` and `emil-design-eng`.
  31. - **Unchanged:** `write-swift` was already native.
  32. ## Checking the code
  33. Two checks run on every push (`.github/workflows/check.yml`). The first checks structure: front matter the installer needs, every upstream skill accounted for, and links and cross-references that resolve:
  34. ```bash
  35. tools/validate.sh
  36. ```
  37. The second typechecks every Swift snippet in the ported skills with an iOS 18 deployment target in Swift 6 mode, debug code included:
  38. ```bash
  39. tools/check-snippets.sh $(ls skills/*/*.md | grep -v /write-swift/) *.md
  40. ```
  41. Run the snippet check outside any sandbox, since the Swift macro plugin server needs its own. Three blocks in `write-swift` fail on purpose. That skill is Emil's original, unchanged. Its examples are fragments that call made-up helpers.
  42. A weekly job (`tools/upstream-diff.sh`) fails when Emil's repo moves past the pinned commit and lists the files he changed, so the port can follow him.
  43. ## Reference
  44. - **[emil-design-eng](skills/emil-design-eng/SKILL.md)**: the core skill. Mostly animation, plus component polish.
  45. - **[animate](skills/animate/SKILL.md)**: builds one animation, choosing curve, duration, properties and exit.
  46. - **[review-animations](skills/review-animations/SKILL.md)**: a strict review of the motion in a diff.
  47. - **[improve-animations](skills/improve-animations/SKILL.md)**: audits every animation in an app and writes plans another agent can run.
  48. - **[find-animation-opportunities](skills/find-animation-opportunities/SKILL.md)**: finds where motion would help, and says where it wouldn't.
  49. - **[remove-animations](skills/remove-animations/SKILL.md)**: removes the motion an app doesn't need.
  50. - **[choreograph](skills/choreograph/SKILL.md)**: coordinates several views moving together.
  51. - **[animation-performance](skills/animation-performance/SKILL.md)**: fixes dropped frames, written for the SwiftUI render pipeline.
  52. - **[animation-vocabulary](skills/animation-vocabulary/SKILL.md)**: names a motion effect and the SwiftUI API that makes it.
  53. - **[apple-design](skills/apple-design/SKILL.md)**: Apple's fluid-interface principles, back on their home platform.
  54. - **[gestures](skills/gestures/SKILL.md)**: drags, swipes and sheets that track the finger and carry the release velocity.
  55. - **[pick-ui-library](skills/pick-ui-library/SKILL.md)**: the first-party component for each task. It names no third-party packages.
  56. - **[prototype](skills/prototype/SKILL.md)**: several versions of a view behind a switcher.
  57. - **[mobile-native](skills/mobile-native/SKILL.md)**: mostly flagged, since a native app has none of the web-on-a-phone problems. The few rules that carry over are kept.
  58. - **[break-ui](skills/break-ui/SKILL.md)**: worst-case data, plus Dynamic Type, right-to-left and accessibility settings.
  59. - **[learn-taste](skills/learn-taste/SKILL.md)**: turns a session's design corrections into rules.
  60. - **[ask-emil](skills/ask-emil/SKILL.md)**: points you to the right skill.
  61. - **[write-swift](skills/write-swift/SKILL.md)**: modern Swift and Swift 6 concurrency.
  62. ## License
  63. MIT, as in the original. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

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