# Spec Ship

> spec-ship

- Skill: `lucassantana-dev/spec-ship` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lucassantana-dev/spec-ship`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lucassantana-dev/spec-ship/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: LucasSantana-Dev (https://skillmd.com/u/lucassantana-dev)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/lucassantana-dev/spec-ship

---


# spec-ship

## When to use
- All checkboxes in the spec's `tasks.md` are ticked.
- The related PR is merged to main.
- Before starting the next feature — keeps the active spec list short.

## Usage
```bash
~/.claude/rag-index/venv/bin/python ~/.claude/rag-index/specs.py ship \
  <repo>/docs/specs/<date>-<slug> \
  [--pr https://github.com/.../pull/N]
```

Effect:
1. Rewrites `spec.md` frontmatter: `status: shipped`, `shipped: <today>`, `pr: <url>`.
2. Moves the entire folder to `docs/specs/archived/<date>-<slug>/`.
3. Archive stays indexed by RAG — future sessions can still retrieve "how we shipped X".

## Do NOT
- Don't delete shipped specs. Archive is the history.
- Don't ship a spec mid-implementation — leave it at `status: active`.

## See also
- `spec-new`, `roadmap-refresh`.