原始内容
ShipSwift Skills
Install once. Build iOS apps with production-ready SwiftUI recipes — right inside your AI coding tool.
ShipSwift provides copy-paste-ready implementations for animations, charts, UI components, and full-stack modules (auth, camera, subscriptions, chat, and more). This repository distributes ShipSwift as an Agent Skill: 81 free recipes are bundled directly inside the skill — no server, no MCP, no configuration.
Quick Start
npx skills add signerlabs/shipswift-skills
That's it. Works with Claude Code, Cursor, Codex, Copilot, Windsurf, Gemini CLI, and 70+ other AI tools. Your AI tool now has the full free recipe catalog locally. Try:
- "Add a shimmer effect to this button"
- "Build an onboarding flow"
- "Show me what ShipSwift offers"
The skill costs almost nothing at rest — recipe docs are loaded only when your AI actually needs them (progressive disclosure).
What You Get
| Category | Count | Examples |
|---|---|---|
| Animation | 40 | Shimmer, Typewriter, Confetti, Mesh Gradient + 27 Metal shader backgrounds |
| Chart | 9 | Line, Bar, Area, Donut, Ring, Radar, Scatter, Heatmap, 3D Network Graph |
| Component | 22 | Onboarding, Alert, Loading, Stepper, Search Bar, Wallet, KPI Card |
| Module | 14 | Auth (Cognito / Supabase), Camera, Chat, Settings, Infra (CDK / Supabase) |
Every recipe is a self-contained doc: architecture overview + full source code + integration checklist + known pitfalls.
81 of 85 recipes are free and bundled in the skill. To update to the latest catalog, just re-run npx skills add signerlabs/shipswift-skills.
ShipSwift Pro
4 advanced module recipes require ShipSwift Pro ($89 one-time, lifetime access): StoreKit 2 Subscriptions, TikTok Ad Attribution, Subject Lifting, and Export & Share.
- Purchase at shipswift.app and get your API key.
- Connect the ShipSwift recipe server (MCP) with your key:
Claude Code:
export SHIPSWIFT_API_KEY=sk_live_xxxxx # add to ~/.zshrc or ~/.bashrc
claude mcp add --transport http shipswift https://api.shipswift.app/mcp \
--header "Authorization: Bearer ${SHIPSWIFT_API_KEY}"
Other tools:
| Tool | Setup |
|---|---|
| Gemini CLI | gemini mcp add --transport http shipswift https://api.shipswift.app/mcp --header "Authorization: Bearer $SHIPSWIFT_API_KEY" |
| Cursor | Add {"mcpServers":{"shipswift":{"type":"streamableHttp","url":"https://api.shipswift.app/mcp","headers":{"Authorization":"Bearer sk_live_xxxxx"}}}} to .cursor/mcp.json |
| VS Code Copilot | Add {"servers":{"shipswift":{"type":"http","url":"https://api.shipswift.app/mcp","headers":{"Authorization":"Bearer sk_live_xxxxx"}}}} to .vscode/mcp.json |
| Windsurf | Add {"mcpServers":{"shipswift":{"serverUrl":"https://api.shipswift.app/mcp","headers":{"Authorization":"Bearer sk_live_xxxxx"}}}} to ~/.codeium/windsurf/mcp_config.json |
Once connected, the skill fetches Pro recipes through the MCP tools (listRecipes, searchRecipes, getRecipe).
Claude Code Plugin
Prefer a one-step install in Claude Code (skill + Pro MCP auto-configured together)?
/plugin marketplace add signerlabs/shipswift-skills
/plugin install shipswift
The plugin bundles the same skill and auto-configures the Pro recipe server using your SHIPSWIFT_API_KEY environment variable.
Repository Structure
signerlabs/shipswift-skills/
├── skills/
│ └── shipswift/
│ ├── SKILL.md # The skill (hand-written)
│ └── references/ # GENERATED — 81 free recipes + index.md
│ ├── index.md # Full catalog (85 recipes, Pro rows marked)
│ ├── animation/ # 40 recipes
│ ├── chart/ # 9 recipes
│ ├── component/ # 22 recipes
│ └── module/ # 10 free recipes
├── plugins/
│ └── shipswift/
│ ├── .mcp.json # Pro recipe server auto-config (Claude Code Plugin)
│ └── skills/shipswift/ # Mirror of skills/shipswift/
└── README.md
references/ and the plugin mirror are maintained by a sync script — recipe content is sourced from the ShipSwift server repo and updated on every release.
Links
- Website: shipswift.app
- iOS Template Repo: github.com/signerlabs/ShipSwift
- Recipe Server (Pro):
https://api.shipswift.app/mcp
License
MIT