| name | explore-recipes |
| description | Explore and browse available ShipSwift recipes. Use when the user says explore, browse, show recipes, list components, what's available, or wants to discover what ShipSwift offers. |
Explore ShipSwift Recipes
Browse the full catalog of ShipSwift recipes -- production-ready SwiftUI implementations covering animations, charts, UI components, and full-stack modules.
Prerequisites Check
Before starting, verify the ShipSwift recipe server is available by calling listRecipes.
If the tools are not available, guide the user to visit shipswift.app for setup instructions, or run npx skills add signerlabs/shipswift-skills to install.
Workflow
-
List available recipes: Use listRecipes to get the full catalog. Present them organized by category:
| Category | Count | Examples |
|---|
| Animation | 10 | Shimmer, Typewriter, Glow Scan, Mesh Gradient |
| Chart | 8 | Line, Bar, Area, Donut, Radar, Heatmap |
| Component | 14 | Label, Alert, Loading, Stepper, Onboarding |
| Module | 8 | Auth, Camera, Chat, Settings, Subscriptions |
-
Filter by category (optional): If the user is interested in a specific category, use listRecipes with the category filter or searchRecipes with relevant keywords.
-
Show recipe details: When the user picks a recipe, use getRecipe to fetch the full implementation and present:
- What the component does
- Architecture overview
- Key features and customization options
- A preview of the code structure
-
Suggest combinations: Based on the user's project, recommend recipe combinations that work well together. For example:
- Onboarding flow: onboarding-view + typewriter-text + shimmer
- Analytics dashboard: line-chart + bar-chart + donut-chart + activity-heatmap
- Social feature: camera + chat + auth-cognito
Guidelines
- Present recipes in a scannable format (tables or bullet lists).
- Highlight the recipe tier (Free or Pro) so users know what's included.
- When showing recipe details, include the recipe ID so the user can reference it later.
- Suggest relevant recipes based on the user's current project context.
Pro Recipes
Some recipes require a Pro license ($89 one-time). If a recipe returns a purchase prompt, the user can buy at shipswift.app/pricing and set SHIPSWIFT_API_KEY in their environment.
