Swift Api Design Guidelines Skill

erikote04/swift-api-design-guidelines-agent-skill

If you're writing or reviewing Swift APIs, this skill enforces the official Swift API Design Guidelines at every step. It checks naming clarity, argument labels, documentation comments, and fluency at call sites, not just declarations in isolation. Use it when designing new interfaces, refactoring existing ones, or reviewing PRs for API consistency. The decision tree walks you through fundamentals, promotes clear usage patterns, and catches common mistakes like ambiguous overloads or weak parameter names. What I like is the practical focus on call-site readability over declaration cleverness, plus the quick reference tables for mutating pairs, label rules, and documentation patterns you can actually apply without rereading the entire guide.

skills.sh installs: 1.2K
GitHub stars: 33
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add erikote04/swift-api-design-guidelines-agent-skill --skill swift-api-design-guidelines-skill --agent claude-code

Installs into .claude/skills of the current project.

Files

Swift API Design Guidelines Skill

Overview

Use this skill to design and review Swift APIs that are clear at the point of use, fluent in call sites, and aligned with established Swift naming and labeling conventions. Prioritize readability, explicit intent, and consistency across declarations, call sites, and documentation comments.

Work Decision Tree

1) Review existing code

Inspect declarations and call sites together, not declarations alone.
Check naming clarity and fluency (see references/promote-clear-usage.md, references/strive-for-fluent-usage.md).
Check argument labels and parameter naming (see references/parameters.md, references/argument-labels.md).
Check documentation comments and symbol markup (see references/fundamentals.md).
Check conventions and overload safety (see references/general-conventions.md, references/special-instructions.md).