macOS / Linux

<div align="center">

<img src="skills/assets/Head.png" alt="Ship Faster" width="720" />

<br />

**16 composable skills + 7 runnable templates for AI coding agents**

*Idea → Code → Deploy in one workflow. Resumable runs. Approval gates. Full audit trail.*

<br />

[![Skills](https://img.shields.io/badge/Skills-16+-8B5CF6?style=for-the-badge)](./skills/)
[![Templates](https://img.shields.io/badge/Templates-7-10B981?style=for-the-badge)](./templates/)
[![MIT License](https://img.shields.io/badge/License-MIT-3B82F6?style=for-the-badge)](LICENSE)

<br />

[📚 Docs](./docs/) · [🛠️ Skills](./skills/) · [📦 Templates](./templates/) · [⚡ Quick Start](#-quick-start)

<br />

English | [简体中文](./README.zh-CN.md)

</div>

---

## 🤔 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

<p align="center">
<img src="https://img.shields.io/badge/Claude_Code-000000?style=flat-square&logo=anthropic&logoColor=white" alt="Claude Code" />
<img src="https://img.shields.io/badge/Cursor-000000?style=flat-square&logo=cursor&logoColor=white" alt="Cursor" />
<img src="https://img.shields.io/badge/OpenCode-412991?style=flat-square&logo=openai&logoColor=white" alt="OpenCode" />
<img src="https://img.shields.io/badge/Any_MCP_Agent-6366F1?style=flat-square" alt="MCP" />
</p>

**Default Stack:**

<p align="center">
<img src="https://img.shields.io/badge/Next.js_16-000000?style=flat-square&logo=next.js&logoColor=white" alt="Next.js" />
<img src="https://img.shields.io/badge/TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript" />
<img src="https://img.shields.io/badge/Supabase-3FCF8E?style=flat-square&logo=supabase&logoColor=white" alt="Supabase" />
<img src="https://img.shields.io/badge/Stripe-635BFF?style=flat-square&logo=stripe&logoColor=white" alt="Stripe" />
<img src="https://img.shields.io/badge/Vercel-000000?style=flat-square&logo=vercel&logoColor=white" alt="Vercel" />
</p>

---

## ⚡ Quick Start

### Option A: Install skills only (10 seconds)

```bash
# 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/
```

<details>
<summary>🪟 Windows (PowerShell)</summary>

```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\"
```

</details>

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

```bash
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
```

---

## 🚀 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` |

<details>
<summary>📋 Full prompt examples</summary>

**💡 Start from scratch:**
```text
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:**
```text
Use workflow-ship-faster.

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

**🎯 One feature (PR-sized):**
```text
Use workflow-feature-shipper.

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

</details>

---

## 🔄 How It Works

<p align="center">
<img src="skills/assets/ship-faster-flow.png" alt="Ship Faster workflow" width="700" />
</p>

Every run writes to di

... (truncated)