Automatically archive finished milestone directories.

Install

mkdir -p .claude/skills/gsd-cleanup && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/13098" && unzip -o skill.zip -d .claude/skills/gsd-cleanup && rm skill.zip

Installs to .claude/skills/gsd-cleanup

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Archive accumulated phase directories from completed milestones
63 charsno explicit “when” trigger
Beginner

Key capabilities

  • Identify completed milestones
  • Show a dry-run summary of cleanup actions
  • Archive phase directories from completed milestones
  • Translate Task() to spawn_agent
  • Handle multi-select workaround for user input

How it works

The skill identifies completed milestones and archives their phase directories into a specified location after user confirmation.

Inputs & outputs

You give it
Accumulated phase directories in .planning/phases/
You get back
Archived phase directories in .planning/milestones/v{X.Y}-phases/

When to use gsd-cleanup

  • Cleaning up project directories
  • Archiving completed phases

About this skill

<codex_skill_adapter>

A. Skill Invocation

  • This skill is invoked by mentioning $gsd-cleanup.
  • Treat all user text after $gsd-cleanup as {{GSD_ARGS}}.
  • If no arguments are present, treat {{GSD_ARGS}} as empty.

B. AskUserQuestion → request_user_input Mapping

GSD workflows use AskUserQuestion (Claude Code syntax). Translate to Codex request_user_input:

Parameter mapping:

  • headerheader
  • questionquestion
  • Options formatted as "Label" — description{label: "Label", description: "description"}
  • Generate id from header: lowercase, replace spaces with underscores

Batched calls:

  • AskUserQuestion([q1, q2]) → single request_user_input with multiple entries in questions[]

Multi-select workaround:

  • Codex has no multiSelect. Use sequential single-selects, or present a numbered freeform list asking the user to enter comma-separated numbers.

Execute mode fallback:

  • When request_user_input is rejected (Execute mode), present a plain-text numbered list and pick a reasonable default.

C. Task() → spawn_agent Mapping

GSD workflows use Task(...) (Claude Code syntax). Translate to Codex collaboration tools:

Direct mapping:

  • Task(subagent_type="X", prompt="Y")spawn_agent(agent_type="X", message="Y")
  • Task(model="...") → omit (Codex uses per-role config, not inline model selection)
  • fork_context: false by default — GSD agents load their own context via <files_to_read> blocks

Parallel fan-out:

  • Spawn multiple agents → collect agent IDs → wait(ids) for all to complete

Result parsing:

  • Look for structured markers in agent output: CHECKPOINT, PLAN COMPLETE, SUMMARY, etc.
  • close_agent(id) after collecting results from each agent </codex_skill_adapter>
<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> @D:/code/Project/tablez-demo2-allByAi/.codex/get-shit-done/workflows/cleanup.md </execution_context>

<process> Follow the cleanup workflow at @D:/code/Project/tablez-demo2-allByAi/.codex/get-shit-done/workflows/cleanup.md. Identify completed milestones, show a dry-run summary, and archive on confirmation. </process>

When not to use it

  • When there are no accumulated phase directories from past milestones

Limitations

  • Requires a specific directory structure for planning and milestones
  • Relies on user confirmation for archiving actions

How it compares

This skill automates the archiving of project phase directories, which would otherwise be a manual file management task.

Compared to similar skills

gsd-cleanup side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
gsd-cleanup (this skill)04moNo flagsBeginner
linear102moNo flagsBeginner
zapier-workflows118moReviewBeginner
attio-skill-generator77moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

linear

lobehub

Linear issue management guide. Use when working with Linear issues, creating issues, updating status, or adding comments. Triggers on Linear issue references (LOBE-xxx), issue tracking, or project management tasks. Requires Linear MCP tools to be available.

10117

zapier-workflows

davila7

Manage and trigger pre-built Zapier workflows and MCP tool orchestration. Use when user mentions workflows, Zaps, automations, daily digest, research, search, lead tracking, expenses, or asks to "run" any process. Also handles Perplexity-based research and Google Sheets data tracking.

11101

attio-skill-generator

kesslerio

Generate use-case-specific Attio workflow skills from templates. Use when creating new skills for lead qualification, deal management, customer onboarding, or custom Attio workflows.

7100

automation-brainstorm

MacroMan5

Interactive workflow design advisor for Power Automate, n8n, Make, Zapier and other platforms. Guides users through planning automation workflows with smart questions about triggers, actions, data flow, and error handling. Uses research sub-agent to find best practices and generates detailed implementation plan. Triggers when user mentions "create workflow", "build flow", "design automation", "need ideas for", or describes workflow requirements without having a complete design.

778

daily-briefing

anthropics

Start your day with a prioritized sales briefing. Works standalone when you tell me your meetings and priorities, supercharged when you connect your calendar, CRM, and email. Trigger with "morning briefing", "daily brief", "what's on my plate today", "prep my day", or "start my day".

761

jira

davila7

Use when the user mentions Jira issues (e.g., "PROJ-123"), asks about tickets, wants to create/view/update issues, check sprint status, or manage their Jira workflow. Triggers on keywords like "jira", "issue", "ticket", "sprint", "backlog", or issue key patterns.

1152

Search skills

Search the agent skills registry