super-ship

Chains a full drift audit with the ship flow to fix stale docs and deploy structural changes.

1|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/robritacca-dotcom/design-system --skill super-ship-robritacca-dotcom
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: super-ship
Source: https://github.com/robritacca-dotcom/design-system/tree/main/.claude/skills/super-ship
Command: npx skills add https://github.com/robritacca-dotcom/design-system --skill super-ship-robritacca-dotcom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Structural changes like moved directories, renamed surfaces, or new build steps can leave a repository's docs and skills stale, and shipping them as-is deploys inaccurate self-descriptions. This Skill runs the full drift audit, fixes the broken and stale findings, then ships the combined result so what deploys and what describes it move together. ## Core Features & Use Cases - Audit-then-ship composition: Runs the complete drift audit across every skill and doc, applies Broken and Stale fixes in-session, then executes the full ship flow including verify, merge, push, and CI monitoring. - Scoped pre-approval: Invoking it pre-approves fixing drift and deploying, while gaps, new validators, and judgement calls are reported as follow-ups rather than built mid-ship. - Atomic deployment: Commits drift fixes separately from session work and ships the combined result or nothing, so docs and code never deploy out of sync. - Use Case: After restructuring a design system's directory layout, invoke super ship to audit every affected doc and skill, repair stale references, re-validate the registry, and deploy the verified result with CI watched to green. ## Quick Start Ask the assistant to super ship the current structural changes so it audits for drift, fixes the findings, and deploys everything together.

Frequently Asked Questions about super-ship

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit and ship a structural change in one step?

Invoke the super ship flow, which runs the full drift audit across every skill and doc, fixes the Broken and Stale findings it surfaces, then executes the complete ship flow including verify, merge, push, and CI watched to green.

When should I use super ship instead of plain ship?

Use super ship after structural or architectural work like a moved directory, renamed surface, or changed dependency model where docs may be stale. For small changes like a copy fix or single-component tweak, plain ship is enough and the audit is unnecessary ceremony.

Does super ship fix every finding the drift audit reports?

No. It fixes Broken and Stale findings in-session, but Gap findings like missing skill coverage or recommended new validators are reported as follow-ups. Judgement calls that could reasonably go two ways stop the flow and ask rather than being resolved silently.

What happens if the drift audit comes back completely clean?

A clean audit is a valid outcome, not a failure. The flow reports that nothing needs fixing and stops if there is nothing to ship, rather than inventing work to justify the run.

Can super ship push session work without the audit fixes?

No. The composition rule requires shipping the combined result or nothing. Drift fixes are committed separately from session work, but both deploy together so the live site and its descriptions never drift apart.