gsd-cleanup — Claude Code skill: what it does, how to install
gsd-cleanup — a skill for Claude Code and other environments that archives phase directories from completed milestones. It runs to clean up the workspace from accumulated planning data.
MIT 573 installs ★ 11,761 updated 2026-11-16
npx skills add open-gsd/gsd-core --skill gsd-cleanup -a claude-codeWhat gsd-cleanup does
This tool moves phase directories from .planning/phases/ into the archive folder .planning/milestones/v{X.Y}-phases/. It helps maintain a clean project structure when directories from past milestones accumulate over time.
The process involves identifying completed milestones, generating a dry-run summary, and archiving files upon confirmation. The skill relies on Bash and Grep tools to locate and move directories, so standard command-line utilities must be available in your development environment.
What it helps with
- archive directories from completed phases
- clean up project structure from old data
- move planning files to archive
Example prompts for the agent
- Archive phase directories from completed milestones.
- Run the cleanup for old project phases.
- Perform a dry-run for phase archiving.
How to install gsd-cleanup
1Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-cleanup -a claude-code2Manually: put the files in place
~/.claude/skills/gsd-cleanup/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gsd-cleanup/
1Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-cleanup -a codex2Manually: put the files in place
.agents/skills/gsd-cleanup/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-cleanup -a cursor2Manually: put the files in place
.cursor/skills/gsd-cleanup/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install open-gsd/gsd-core skills/gsd-cleanup2Manually: put the files in place
.github/skills/gsd-cleanup/SKILL.md1Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-cleanup -a gemini-cli2Platform CLI
gemini skills install https://github.com/open-gsd/gsd-core --path skills/gsd-cleanupManually: put the files in place
.devin/skills/gsd-cleanup/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add open-gsd/gsd-core --skill gsd-cleanup -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about gsd-cleanup
How to install gsd-cleanup in Claude Code?
Run the command npx skills add open-gsd/gsd-core --skill gsd-cleanup -a claude-code in your project terminal.
What does gsd-cleanup do?
It automatically identifies and moves phase directories from .planning/phases/ to the archive directory .planning/milestones/v{X.Y}-phases/.
What is required for gsd-cleanup to work?
The skill requires Bash and Grep utilities to be available in your system for file operations.
Source text
SKILL.md · MIT
---
name: gsd-cleanup
description: "Archive accumulated phase directories from completed milestones"
allowed-tools:
- Read
- Write
- Bash
- Grep
- AskUserQuestion
---
<objective>
Archive phase directories from completed milestones into `.planning/milestones/v{X.Y}-phases/`.
Use when `.planning/phases/` has accumulated directories from past milestones.
</objective>
<execution_context>
@~/.claude/gsd-core/workflows/cleanup.md
</execution_context>
<process>
Execute end-to-end.
Identify completed milestones, show a dry-run summary, and archive on confirmation.
</process>
© open-gsd · MIT · open-gsd/gsd-core