Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add open-gsd/gsd-core --skill gsd-cleanup -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/gsd-cleanup/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gsd-cleanup/

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

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set72

The whole set →
gsd-surface gsd-surface is a Claude Code skill that changes which GSD skills are active without reinstalling them. It also reports enabled clusters and token cost. CX Codex +1 573installs gsd-manager The gsd-manager skill for Claude Code tracks milestone phases and dispatches work to agents. Discuss one phase in the terminal while planning or execution runs in the background. CX Codex +1 573installs gsd-forensics gsd-forensics is a Claude Code skill that investigates failed GSD workflows by analyzing git history and generating structured post-mortem reports. CX Codex +1 573installs gsd-ns-context The gsd-ns-context Claude Code skill routes codebase requests to the matching tool. It handles tasks such as mapping a project, building a knowledge graph, and recalling past decisions. CX Codex +1 573installs gsd-mempalace-recall The gsd-mempalace-recall Claude Code skill retrieves decisions, patterns, and surprises from MemPalace before planning. It saves relevant findings to MEMORY-RECALL.md in the active phase directory. CX Codex +1 573installs gsd-ns-project gsd-ns-project is a Claude Code skill that routes project lifecycle requests to the appropriate development phase handlers, including milestone operations. CX Codex +1 573installs gsd-fast The gsd-fast Claude Code skill handles small tasks in the current context. Use it for typo fixes, config edits, and minor code changes. CX Codex +1 573installs gsd-milestone-summary gsd-milestone-summary — a skill for Claude Code builds a project summary from completed milestone files. It runs for project reviews or when new teammates need a concise account of the work. CX Codex +1 572installs

Project sponsors

Companies that keep this analytics open