Skip to main content
The Shipfox skills package encodes the complete workflow YAML schema, the hard validation rules, the shipped-vs-roadmap boundary, and correct examples into your AI coding tool. Install it once and your agent will author valid Shipfox workflows without a copy/paste prompt.

​
Install

npx skills add shipfox/agent-skills
This installs the skill via skills.sh and makes it available to Claude Code, Cursor, Codex, and 18+ other agent frameworks automatically — no manual configuration required per tool.

​
What the skill includes

Once installed, the skill gives your agent immediate access to:
  • The complete shipped workflow YAML schema in compact, agent-optimized form
  • Hard validation rules — strict key allowlists, step kind constraints, env restrictions, and the one-manual-trigger limit
  • The today/roadmap boundary — what NOT to use (loop, matrix, branch, trigger filter evaluation) and what IS shipped, like ${{ }} interpolation
  • Two correct examples: a push-triggered checks pipeline and an agent fix-until-green loop

​
Usage

Once the skill is installed, just ask your agent in plain language. No schema pasting, no special syntax:
  • “Add a Shipfox workflow that runs tests on every push.”
  • “Create a Shipfox workflow that triages Sentry issues with an agent.”
  • “Add a gate to my workflow that retries until the tests pass.”
The skill activates automatically whenever the agent detects a Shipfox context — such as a .shipfox/ directory in the repo — or whenever you mention Shipfox workflows explicitly.

​
Supported tools

The skills package works with any tool supported by skills.sh, including Claude Code, Cursor, Codex, Grok, Copilot, and 15+ others.

​
Skills vs. copy/paste prompt

Both options give your agent the full Shipfox schema. The right choice depends on how often you work with Shipfox workflows.
Skills PackageCopy/Paste Prompt
InstallationOne npx commandManual paste per session
Stays currentRe-run install for latestMust re-paste after schema changes
Tool support18+ agents via skills.shAny agent that accepts a system prompt
Best forRegular Shipfox usersQuick one-off sessions
The skills package is generated from the Shipfox workflow schema source. When you re-run the install command, you get the latest version aligned with the current schema.
If you prefer not to install the skills package, the Authoring Prompt page has a single copy/paste block with the full schema cheat sheet — paste it once at the start of any session.