Moves the entire folder to docs/specs/archived/<date>-<slug>/.
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.
1---2name: spec-ship3description: spec-ship4---56# spec-ship78## When to use9- All checkboxes in the spec's `tasks.md` are ticked.10- The related PR is merged to main.11- Before starting the next feature — keeps the active spec list short.1213## Usage14```bash15~/.claude/rag-index/venv/bin/python ~/.claude/rag-index/specs.py ship \16 <repo>/docs/specs/<date>-<slug> \17 [--pr https://github.com/.../pull/N]18```1920Effect:211. Rewrites `spec.md` frontmatter: `status: shipped`, `shipped: <today>`, `pr: <url>`.222. Moves the entire folder to `docs/specs/archived/<date>-<slug>/`.233. Archive stays indexed by RAG — future sessions can still retrieve "how we shipped X".2425## Do NOT26- Don't delete shipped specs. Archive is the history.27- Don't ship a spec mid-implementation — leave it at `status: active`.2829## See also30- `spec-new`, `roadmap-refresh`.
Run npx skillmds@latest add lucassantana-dev/spec-ship in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
spec-ship It is listed under Coding & Dev Tools on SkillMD.
SkillMD's automated safety review verdict for this skill is PASS. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
LucasSantana-Dev (@lucassantana-dev) published this skill. Their other Agent Skills are listed on their SkillMD profile.
LucasSantana-Dev