Install Factory Ship
Pick your agent. Every command is ready to paste.
npx skills add BuilderIO/skills --skill factory-shipThe open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.
01
Install it
Run the command above, or upload the folder in Claude.
02
Ask naturally
Describe the task. Your agent loads factory-ship when the request matches its description.
03
Name it if needed
If it does not trigger, say “use the factory-ship skill”. In Codex, type $factory-ship.
Factory Ship
Start with the Factory guide for workflow setup and configuration.
Read .agent-factory/config.yaml, the optional
skill_prompts.factory-ship entry, and the repository's instructions before
publishing. See the Factory configuration reference. The prompt adds project guidance; editing code does not by itself authorize a PR update, approval, merge, or deployment.
Delivery steps
- Confirm ownership. Identify the target repository, task-owned worktree, branch, and complete task-related change set. Preserve unrelated changes. Use a clean automation-owned worktree when the scheduler provides one; never take over a peer's checkout.
- Verify changes. Run the configured formatter, tests, and release checks. Report checks that were skipped or unavailable.
- Publish when enabled. Open or update a PR only when authorized. Apply configured title, body, draft status, labels, and communication rules. Do not tag or message people unless enabled.
- Resolve feedback. Compare comments with the code and current human direction. Make one coherent update, then rerun affected checks.
- Apply merge gates. Merge only under its own enabled policy and while all criteria hold on the unchanged live head. Use a head-match guard when the host supports it. A head change invalidates tied evidence and resets the soak.
- Verify and close out. Confirm the merge in the current base branch. Verify deployment only when configured; a merge is not live proof. Close issues, rotate worktrees, and notify only at their configured proof points.
Stop conditions
Hold the work when ownership, authorization, a required check, or live host state is missing or unclear. State the exact next step; do not turn an inconclusive result into success.
Tips for Factory Ship
- • Start a fresh session after installing so your agent picks up the new skill.
- • It is part of a pack with 26 skills. Install only the ones you need with --skill to keep triggers precise.
- • If two skills overlap, mention the one you want by name.
Questions about Factory Ship
What does the Factory Ship skill do?
Experimental workflow for publishing and completing configured software delivery work. Use when the user or an enabled factory policy asks to ship.
How do I install Factory Ship?
Run "npx skills add BuilderIO/skills --skill factory-ship" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.
Does Factory Ship work in Cursor and Codex?
Yes. Factory Ship uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.
Is Factory Ship free?
Factory Ship is open source on GitHub under the MIT license. It is free to install; check the license before commercial use.
Who made Factory Ship?
Factory Ship is published by BuilderIO in the BuilderIO/skills repository, together with 25 other skills.





