# Swift API Design

> Design, rename, or review Swift API surfaces using the bundled official API Design Guidelines.

- Skill: `alemar11/swift-api-design` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add alemar11/swift-api-design`
- Raw SKILL.md: https://api.skillmd.com/api/skills/alemar11/swift-api-design/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: alemar11 (https://skillmd.com/u/alemar11)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/alemar11/swift-api-design

---


# Swift API Design

Judge APIs from realistic call sites. Show the recommended signature, useful
call-site examples, and the guideline supporting a change. Apply this skill
when API shape is in scope, not for every Swift implementation task.

Read the reference matching the decision:

- Principles or competing designs: [core principles](references/core-principles.md).
- Names, labels, defaults, or overloads: [naming and signatures](references/naming-and-signatures.md).
- Weak domain types, Boolean parameters, or method families: [API patterns](references/common-api-shaping-patterns.md).
- Existing API audit: [review checklist](references/review-checklist.md).
- Exact upstream wording or examples: [official guidelines](assets/api-design-guidelines.md).
- Bundled revision: `assets/manifest.json`.