# Gsd List Milestones

> Display completed milestones from the MILESTONES.md registry

- Skill: `majiayu000/gsd-list-milestones` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/gsd-list-milestones`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/gsd-list-milestones/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/gsd-list-milestones

---



<objective>
Display completed milestones from the MILESTONES.md registry.

Purpose: Show milestone history without scanning filesystem.
Output: Formatted list of completed milestones with key accomplishments.
</objective>

<execution_context>
@.github/get-shit-done/references/ui-brand.md
</execution_context>

<context>
Registry file:
- `.planning/MILESTONES.md` — Milestone completion registry
</context>

<process>

<step name="check_registry_exists">
Check if milestone registry exists using bash:

```bash
if [ ! -f .planning/MILESTONES.md ]; then
    echo ""
    echo "No milestones completed yet."
    echo ""
    echo "Complete your first milestone with:"
    echo "  /gsd-complete-milestone"
    echo ""
    exit 0
fi
```

If registry doesn't exist: Show friendly message and exit.
If registry exists: Continue to display step.
</step>

<step name="display_milestones">
Display milestone history from registry:

```bash
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo " GSD ► MILESTONE HISTORY"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""

# Display registry content
cat .planning/MILESTONES.md

echo ""
echo "───────────────────────────────────────────────────────────────"
echo ""
echo "Archived milestones are in: .planning/history/"
echo ""
echo "To view archived files:"
echo "  ls .planning/history/v1.0/"
echo "  cat .planning/history/v1.0/ROADMAP.md"
echo ""
echo "To start new milestone:"
echo "  /gsd-new-milestone"
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
```
</step>

</process>

<success_criteria>
- [ ] Registry existence checked before display
- [ ] Friendly message if no milestones completed yet
- [ ] MILESTONES.md content displayed directly (no parsing)
- [ ] Helpful bash commands shown for accessing archives
- [ ] User knows next command (complete-milestone or new-milestone)
- [ ] Template variables (/gsd-) used for cross-platform support
</success_criteria>