gsd-cleanup
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.zipInstalls 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 milestonesKey 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
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-cleanupas{{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:
header→headerquestion→question- Options formatted as
"Label" — description→{label: "Label", description: "description"} - Generate
idfrom header: lowercase, replace spaces with underscores
Batched calls:
AskUserQuestion([q1, q2])→ singlerequest_user_inputwith multiple entries inquestions[]
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_inputis 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: falseby 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>
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.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| gsd-cleanup (this skill) | 0 | 4mo | No flags | Beginner |
| linear | 10 | 2mo | No flags | Beginner |
| zapier-workflows | 11 | 8mo | Review | Beginner |
| attio-skill-generator | 7 | 7mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by AdityaArote
View all by AdityaArote →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.
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.
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.
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.
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".
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.