Add Component
Developmentadd-componentAdd Component is an Agent Skill for development published in the signerlabs/ShipSwift repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Add a SwiftUI component from ShipSwift. Use when the user says "add component", "add a view", "add X view", "I need a chart", "add animation", or wants a specific UI element.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/signerlabs/ShipSwift/blob/HEAD/skills/add-component/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/add-component, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Add Component from ShipSwift
Add production-ready SwiftUI components to your project from ShipSwift's local source library.
Workflow
-
Identify the component: Read
skills/catalog.mdto find the right component. Common mappings:- "shimmer" / "loading skeleton" →
SWAnimation/SWShimmer.swift - "donut chart" / "pie chart" →
SWChart/SWDonutChart.swift - "alert" / "popup" →
SWComponent/Feedback/SWAlert.swift - "auth" / "login" →
SWModule/SWAuth/(all files) - "camera" →
SWModule/SWCamera/(all files)
- "shimmer" / "loading skeleton" →
-
Read the source file: Read the Swift file from
ShipSwift/SWPackage/<path>. The file contains the complete implementation. -
Integrate into the project:
- Copy the file(s) into the user's project
- Also copy
SWUtil/if not already present - Adapt naming, colors, and data models to match the project
- For
+iOS/+macOSfiles, set the platform filter in Xcode Build Phases
-
Verify: Walk through any dependencies or setup steps needed.
Guidelines
- Types use
SWprefix (SWDonutChart,SWTypewriter). - View modifiers use
.swprefix (.swShimmer(),.swGlowScan()). - Chart components use a generic
CategoryTypepattern withStringconvenience initializer. - Internal helper types should be
privatewithSWprefix. - Components in
SWAnimation/,SWChart/, andSWComponent/are each self-contained (single file + SWUtil). - Modules in
SWModule/are multi-file — copy the entire folder.