Most AI tools give you pieces. This gives you a process.

From idea to deploy — without losing context.

📚 Docs · 🗂️ Skills Catalog · 🛠️ Skills · 📦 Templates · ⚡ Quick Start

English | 简体中文

---

🤔 Why Ship Faster?

Without	With Ship Faster
😩 Agent loses context mid-task	✅ Every run writes to disk — resumable anytime
🔥 No audit trail	✅ Full logs + evidence for replay/review
💣 Risky deploys, DB writes, payments	✅ Approval gates before side effects
🎲 Ad-hoc prompts, inconsistent outputs	✅ Composable skills with predictable structure

---

🎯 Who is this for?

• 🤖 AI coding agents (Claude Code, Cursor, OpenCode, etc.) — skills are the primary interface
• 👨‍💻 Developers who operate those agents — copy/paste prompts, review artifacts, approve gates
• 👥 Teams who want reproducible, auditable AI-assisted development

💡 This is NOT a CLI, NOT a SaaS. It's a set of files you copy into your agent's skill directory.

---

🔗 Works With

• Agents: Claude Code, Cursor, OpenCode, any MCP-capable agent
• Default stack assumptions: Next.js + TypeScript + Supabase + Stripe + Vercel

---

⚡ Quick Start

Option A: Install skills only (10 seconds)

# macOS / Linux
mkdir -p ~/.claude/skills
curl -L https://github.com/Heyvhuang/ship-faster/archive/refs/heads/main.tar.gz \
  | tar -xz --strip-components=2 -C ~/.claude/skills ship-faster-main/skills/

🪟 Windows (PowerShell)

New-Item -ItemType Directory -Force -Path "$HOME\.claude\skills" | Out-Null
$zip = "$env:TEMP\ship-faster-main.zip"
Invoke-WebRequest -Uri "https://github.com/Heyvhuang/ship-faster/archive/refs/heads/main.zip" -OutFile $zip
Expand-Archive -Path $zip -DestinationPath "$env:TEMP\ship-faster" -Force
Copy-Item -Recurse -Force "$env:TEMP\ship-faster\ship-faster-main\skills\*" "$HOME\.claude\skills\"

Option B: Clone for templates + skills (30 seconds)

git clone https://github.com/Heyvhuang/ship-faster.git
cd ship-faster

# Copy skills to your agent
cp -r skills/* ~/.claude/skills/

# Or run a template directly
cd templates/001-copyback-studio && pnpm install && pnpm dev

Option C: Install via skills.sh (npx)

# List available skills
npx --yes skills add Heyvhuang/ship-faster --list

# Install all skills (Claude Code)
npx --yes skills add Heyvhuang/ship-faster --yes --agent claude-code

# Install a single skill
npx --yes skills add Heyvhuang/ship-faster --yes --agent claude-code --skill workflow-ship-faster

---

🚀 Pick Your Path

Once skills are installed, paste one of these into your agent:

Scenario	Prompt
💡 I have an idea	Use workflow-project-intake
📦 I have a repo	Use workflow-ship-faster
🎯 I want one feature	Use workflow-feature-shipper
🎨 I need UI/UX direction	Use tool-design-style-selector

📋 Full prompt examples

💡 Start from scratch:

Use workflow-project-intake.

Idea: <what are we building?>
Users: <who is it for?>
Must-have: <3-5 bullets>
Constraints: <deadline / tech / design / infra>
Need: deploy? database? billing? seo?

📦 Ship existing repo:

Use workflow-ship-faster.

Repo path: <absolute path or '.'>
Constraints: <deadline / tech / non-goals>
Need: deploy? database? billing? seo?

🎯 One feature (PR-sized):

Use workflow-feature-shipper.

Repo path: <absolute path or '.'>
Feature: <one sentence>
Acceptance criteria:
- <bullet>
- <bullet>
Non-goals:
- <bullet>

---

🔄 How It Works

Every run writes to disk for replay/audit/resume:

runs/ship-faster/active/<run_id>/
├── proposal.md      # Why/what/scope (stable context)
├── tasks.md         # Checklist [ ] → [x] (resume here!)
├── context.json     # Switches (deploy/db/billing/seo)
├── evidence/        # Large outputs / audits
└── logs/            # Debug events

📖 Learn more: Runs & Approvals

---

🎮 Pixel Office Kit

_{Agents · autonomous behavior · day/night cycle · canvas rendering — Pro: real-time interactions + moods + conversations + matrix effects + OpenClaw integration}

---

🛠️ Skills (34)

Composable workflows that ship end-to-end. Copy to ~/.claude/skills/.

🔄 Workflows

• ⚡ workflow-ship-faster — End-to-end: idea → foundation → design → deploy
• 📥 workflow-project-intake — Brainstorm → clarify → route to workflow
• 🚀 workflow-feature-shipper — PR-sized feature iteration
• 🧠 workflow-brainstorm — One question at a time → design spec
• 📋 workflow-execute-plans — Batch execution with checkpoints
• 📤 workflow-template-extractor — Extract runnable template from real project
• 🌱 workflow-template-seeder — Seed new template from spec

🔧 Tools

• 🎨 tool-design-style-selector — Scan project → generate design-system.md
• 🖌️ tool-ui-ux-pro-max — Palette / typography / UX lookup database
• 🔍 tool-ast-grep-rules — AST-based code search & rewrite
• 🔎 deep-research — Deep codebase research in an isolated Explore subagent
• 🧰 tool-hooks-doctor — Check/install Claude Code evolution hooks
• 🔐 tool-better-auth — Better Auth integration guidance
• 🧪 tool-systematic-debugging — Root-cause-first debugging process
• 🧩 tool-schema-markup — Structured data / JSON-LD guidance
• 📈 tool-programmatic-seo — Template-driven pages at scale
• 📝 tool-x-article-publisher — Publish Markdown to X Articles
• 📣 publish-x-article — Publish Markdown to X Articles (alt name)

🔎 Reviews

• ✅ review-quality — Merge readiness + maintainability + docs audit
• ⚛️ review-react-best-practices — React/Next.js performance rules
• 🔍 review-seo-audit — SEO audit framework
• 🧹 review-clean-code — Clean Code principles analysis
• 📄 review-doc-consistency — Docs vs code alignment check
• 🚦 review-merge-readiness — Structured PR review with verdict

🔌 Services

• 🗄️ supabase — DB ops with approval gates + bundled Postgres best practices
• 💳 stripe — Billing ops with confirmation gates
• ☁️ cloudflare — Workers / KV / R2 / D1 infrastructure

🔌 Services (MCP)

• 🗄️ mcp-supabase — Supabase via MCP with write confirmation
• 💳 mcp-stripe — Stripe MCP transactions with approval gates
• ☁️ mcp-cloudflare — Cloudflare MCP with permission tiers

🧬 Meta

• 🔄 skill-evolution — Capture context → generate patches
• ✨ skill-creator — Create new skills from scratch
• 🔧 skill-improver — Analyze runs → improve skills
• 🔗 workflow-creator — Create workflow chains from existing skills

📋 Full catalog: skills/manifest.json

---

📦 Templates (7)

Runnable example projects — demos + regression references.

	Template	Stack	Description
🎨	CopyBack Studio	Next.js + Supabase + R2	AI image workflow
📊	UnitEconomics Console	Next.js	Business metrics dashboard
💰	MarginLedger	Vite + React	Profit margin tracker
📋	Kanban Load Mirror	Vite + React	Task load balancing
📈	Multi-Store Daily Brief	Vite + React	Retail analytics
❓	Ticket to FAQ	Vite + React	Support → FAQ generator
🏠	Elevate Move-in Booking	Vite + React	Appointment scheduling

💡 The repo root is not runnable. Pick a template or run skills against your own project.

---

🎮 Components

Standalone UI components — embed in your own projects.

	Component	Stack	Description
🏢	Pixel Office Kit	Next.js + Canvas	AI agent pixel office — watch agents work, walk, and collaborate

Preview: Pixel Office Kit

_{4 agents · auto behavior · day/night cycle — Pro: 6 agents + moods + conversations + matrix effects + OpenClaw integration}

---

Repository Structure

ship-faster/
├── docs/                         # Documentation
├── templates/                    # Runnable full projects
│   ├── 001-copyback-studio/
│   ├── 002-uniteconomics-console/
│   ├── 003-marginledger/
│   ├── 004-kanban-load-mirror/
│   ├── 005-multi-store-daily-brief/
│   ├── 006-ticket-to-faq/
│   └── 007-elevate-move-in-booking/
├── skills/                       # Agent skill packages
│   ├── workflow-ship-faster/
│   ├── workflow-project-intake/
│   ├── review-*/
│   ├── tool-*/
│   ├── supabase/
│   ├── stripe/
│   ├── cloudflare/
│   └── assets/                   # Diagrams and static assets
├── pixel-office-kit/             # AI agent pixel office component
├── snippets/                     # Internal reference code
│   └── product-starter/
├── LICENSE
├── README.md

Naming Convention

Type	Pattern	Example
Templates	templates/<NNN>-<slug>/	001-copyback-studio
Snippets	snippets/<slug>/	product-starter
Skills	skills/<prefix>-<slug>/	workflow-ship-faster

Prefixes: workflow-, tool-, review-, skill- Service skills (supabase, stripe, cloudflare) use the service name directly.

Update / Uninstall

Update (overwrite existing skills):

Note: this only overwrites skill folders with the same name; other folders in ~/.claude/skills/ are untouched.

curl -L https://github.com/Heyvhuang/ship-faster/archive/refs/heads/main.tar.gz \
  | tar -xz --strip-components=2 -C ~/.claude/skills ship-faster-main/skills/

Install single skill:

git clone https://github.com/Heyvhuang/ship-faster.git
cp -r ship-faster/skills/workflow-ship-faster ~/.claude/skills/

Uninstall: Delete skill folders from ~/.claude/skills/ (see skills/manifest.json for names).

Adding Templates / Snippets

New Template:

1. Create templates/<NNN>-<slug>/
2. Include README.md and .env.local.example

New Snippet:

1. Create snippets/<slug>/
2. Include README.md explaining what skills should copy

---

🔒 Security

• Never commit secrets or .env.local files
• Build outputs (.next/, *.tsbuildinfo) are gitignored
• Write operations (DB, deploy, payments) require explicit approval

---

📜 License

MIT License — see LICENSE

---

Made by VoxYZ

Ship small. Ship fast. Ship often.

Links: Twitter · GitHub