Using the Build Kit
Install Build Kit items into Claude Code, Codex, Cursor or Claude in Xcode, use them over MCP, or copy them, and get good work out of them.
Build Kit items are Agent Skills: a folder holding one SKILL.md. There are three ways to hand one to your agent. Install it with the CLI, let your agent fetch it over MCP, or copy it from its page. The overview lists every item.
Install into your agent
The CLI writes each item as an Agent Skill (a folder with a SKILL.md), where your agent looks for skills. Run it from your project root:
npx swiftpieces add swift-pieces style-studio brief-finance recipe-send-money| Agent | Flag | Written to |
|---|---|---|
| Claude Code | --agent claude (default when .claude/ exists) | .claude/skills/<name>/SKILL.md |
Codex, and other agents that read .agents | --agent codex | .agents/skills/<name>/SKILL.md |
| Cursor | --agent cursor | .cursor/skills/<name>/SKILL.md |
| Claude in Xcode | --agent xcode | ~/Library/Developer/Xcode/CodingAssistant/ClaudeAgentConfig/skills/<name>/ |
Add --global to install for every project (~/.claude/skills, ~/.agents/skills or ~/.cursor/skills). Pass several agents at once with --agent claude,codex. You can mix kit ids and library ids in the same add: skills go to the agent, and screens go to your SwiftPieces folder.
After a recipe installs, the CLI prints the add line for the screens it assembles.
Or skip installing: MCP
With the Pro MCP server connected, your agent can list the kit and read any item on demand (list_kit, get_kit_item). Every item is also an MCP prompt, so in Claude Code it appears as a slash command:
/mcp__swiftpieces-pro__recipe-send-money add sending money to the Wallet tabOr copy it
Every item page has Copy for your agent and Download SKILL.md. Paste the text into any chat, or drop the file into a skills folder yourself.
Ask for good work
- Name the style before the first view. "Use style-press" makes the agent apply the theme first. It can't match a look it has never been told about.
- Let recipes install screens. A recipe tells your agent which pieces to add with the CLI or MCP. Don't let it rebuild a screen that is already in the library.
- Run the self-check. Every style ends with a verification loop: build, take simulator screenshots, and check the largest text size, dark mode and Reduce Motion. Ask your agent to run it and fix what it finds.
- Review before you ship.
tool-reviewscores a screen against the rubric every Pro screen ships at. Anything under 4 comes back with the fix.
Licensing
Build Kit items are included with Swift Pieces Pro for use in your own and your clients' apps. Sharing, reselling or publishing their text is not permitted. The swift-pieces setup skill is free for everyone.