Skip to main content

retro

Analyzes commit history and work patterns to generate engineering retrospectives, enhancing team performance and code quality.

Install this skill

or
0/100

Security score

The retro skill was audited on Jun 10, 2026 and we found 102 security issues across 3 threat categories, including 1 high-severity. Review the findings below before installing.

Categories Tested

Security Issues

medium line 50

Template literal with variable interpolation in command context

SourceSKILL.md
50```bash
medium line 300

Template literal with variable interpolation in command context

SourceSKILL.md
300```bash
medium line 435

Template literal with variable interpolation in command context

SourceSKILL.md
435```bash
medium line 469

Template literal with variable interpolation in command context

SourceSKILL.md
469echo "before relying on \`gbrain search\` for code questions in this worktree."
medium line 597

Template literal with variable interpolation in command context

SourceSKILL.md
597```bash
medium line 1253

Template literal with variable interpolation in command context

SourceSKILL.md
1253```bash
medium line 1697

Template literal with variable interpolation in command context

SourceSKILL.md
1697```bash
high line 1704

Template literal with variable interpolation in command context

SourceSKILL.md
1704Use the Write tool to save JSON to `~/.gstack/retros/global-${today}-${next}.json`:
medium line 21

Access to hidden dotfiles in home directory

SourceSKILL.md
21glob: "~/.gstack/projects/{repo_slug}/retros/*.md"
medium line 27

Access to hidden dotfiles in home directory

SourceSKILL.md
27glob: "~/.gstack/projects/{repo_slug}/timeline.jsonl"
medium line 32

Access to hidden dotfiles in home directory

SourceSKILL.md
32glob: "~/.gstack/projects/{repo_slug}/learnings.jsonl"
low line 51

Access to hidden dotfiles in home directory

SourceSKILL.md
51_UPD=$(~/.claude/skills/gstack/bin/gstack-update-check 2>/dev/null || .claude/skills/gstack/bin/gstack-update-check 2>/dev/null || true)
low line 53

Access to hidden dotfiles in home directory

SourceSKILL.md
53mkdir -p ~/.gstack/sessions
low line 54

Access to hidden dotfiles in home directory

SourceSKILL.md
54touch ~/.gstack/sessions/"$PPID"
low line 55

Access to hidden dotfiles in home directory

SourceSKILL.md
55_SESSIONS=$(find ~/.gstack/sessions -mmin -120 -type f 2>/dev/null | wc -l | tr -d ' ')
low line 56

Access to hidden dotfiles in home directory

SourceSKILL.md
56find ~/.gstack/sessions -mmin +120 -type f -exec rm {} + 2>/dev/null || true
low line 57

Access to hidden dotfiles in home directory

SourceSKILL.md
57_PROACTIVE=$(~/.claude/skills/gstack/bin/gstack-config get proactive 2>/dev/null || echo "true")
low line 58

Access to hidden dotfiles in home directory

SourceSKILL.md
58_PROACTIVE_PROMPTED=$([ -f ~/.gstack/.proactive-prompted ] && echo "yes" || echo "no")
low line 61

Access to hidden dotfiles in home directory

SourceSKILL.md
61_SKILL_PREFIX=$(~/.claude/skills/gstack/bin/gstack-config get skill_prefix 2>/dev/null || echo "false")
low line 65

Access to hidden dotfiles in home directory

SourceSKILL.md
65source <(~/.claude/skills/gstack/bin/gstack-repo-mode 2>/dev/null) || true
low line 68

Access to hidden dotfiles in home directory

SourceSKILL.md
68_SESSION_KIND=$(~/.claude/skills/gstack/bin/gstack-session-kind 2>/dev/null || echo "interactive")
low line 71

Access to hidden dotfiles in home directory

SourceSKILL.md
71_LAKE_SEEN=$([ -f ~/.gstack/.completeness-intro-seen ] && echo "yes" || echo "no")
low line 73

Access to hidden dotfiles in home directory

SourceSKILL.md
73_TEL=$(~/.claude/skills/gstack/bin/gstack-config get telemetry 2>/dev/null || true)
low line 74

Access to hidden dotfiles in home directory

SourceSKILL.md
74_TEL_PROMPTED=$([ -f ~/.gstack/.telemetry-prompted ] && echo "yes" || echo "no")
low line 79

Access to hidden dotfiles in home directory

SourceSKILL.md
79_EXPLAIN_LEVEL=$(~/.claude/skills/gstack/bin/gstack-config get explain_level 2>/dev/null || echo "default")
low line 82

Access to hidden dotfiles in home directory

SourceSKILL.md
82_QUESTION_TUNING=$(~/.claude/skills/gstack/bin/gstack-config get question_tuning 2>/dev/null || echo "false")
low line 84

Access to hidden dotfiles in home directory

SourceSKILL.md
84mkdir -p ~/.gstack/analytics
low line 86

Access to hidden dotfiles in home directory

SourceSKILL.md
86echo '{"skill":"retro","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","repo":"'$(_repo=$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null | tr -cd 'a-zA-Z0-9._-'); echo "${_repo:-unknown}"
low line 88

Access to hidden dotfiles in home directory

SourceSKILL.md
88for _PF in $(find ~/.gstack/analytics -maxdepth 1 -name '.pending-*' 2>/dev/null); do
low line 90

Access to hidden dotfiles in home directory

SourceSKILL.md
90if [ "$_TEL" != "off" ] && [ -x "~/.claude/skills/gstack/bin/gstack-telemetry-log" ]; then
low line 91

Access to hidden dotfiles in home directory

SourceSKILL.md
91~/.claude/skills/gstack/bin/gstack-telemetry-log --event-type skill_run --skill _pending_finalize --outcome unknown --session-id "$_SESSION_ID" 2>/dev/null || true
low line 97

Access to hidden dotfiles in home directory

SourceSKILL.md
97eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
low line 103

Access to hidden dotfiles in home directory

SourceSKILL.md
103~/.claude/skills/gstack/bin/gstack-learnings-search --limit 3 2>/dev/null || true
low line 108

Access to hidden dotfiles in home directory

SourceSKILL.md
108~/.claude/skills/gstack/bin/gstack-timeline-log '{"skill":"retro","event":"started","branch":"'"$_BRANCH"'","session":"'"$_SESSION_ID"'"}' 2>/dev/null &
low line 113

Access to hidden dotfiles in home directory

SourceSKILL.md
113_ROUTING_DECLINED=$(~/.claude/skills/gstack/bin/gstack-config get routing_declined 2>/dev/null || echo "false")
low line 124

Access to hidden dotfiles in home directory

SourceSKILL.md
124_CHECKPOINT_MODE=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_mode 2>/dev/null || echo "explicit")
low line 125

Access to hidden dotfiles in home directory

SourceSKILL.md
125_CHECKPOINT_PUSH=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_push 2>/dev/null || echo "false")
medium line 146

Access to hidden dotfiles in home directory

SourceSKILL.md
146In plan mode, allowed because they inform the plan: `$B`, `$D`, `codex exec`/`codex review`, writes to `~/.gstack/`, writes to the plan file, and `open` for generated artifacts.
medium line 154

Access to hidden dotfiles in home directory

SourceSKILL.md
154If `SKILL_PREFIX` is `"true"`, suggest/invoke `/gstack-*` names. Disk paths stay `~/.claude/skills/gstack/[skill-name]/SKILL.md`.
medium line 156

Access to hidden dotfiles in home directory

SourceSKILL.md
156If output shows `UPGRADE_AVAILABLE <old> <new>`: read `~/.claude/skills/gstack/gstack-upgrade/SKILL.md` and follow the "Inline upgrade flow" (auto-upgrade if configured, otherwise AskUserQuestion with
medium line 161

Access to hidden dotfiles in home directory

SourceSKILL.md
161- Missing `~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint`: AskUserQuestion for Continuous checkpoint auto-commits. If accepted, run `~/.claude/skills/gstack/bin/gstack-config set che
medium line 162

Access to hidden dotfiles in home directory

SourceSKILL.md
162- Missing `~/.claude/skills/gstack/.feature-prompted-model-overlay`: inform "Model overlays are active. MODEL_OVERLAY shows the patch." Always touch marker.
medium line 175

Access to hidden dotfiles in home directory

SourceSKILL.md
175If B: run `~/.claude/skills/gstack/bin/gstack-config set explain_level terse`.
low line 179

Access to hidden dotfiles in home directory

SourceSKILL.md
179rm -f ~/.gstack/.writing-style-prompt-pending
low line 180

Access to hidden dotfiles in home directory

SourceSKILL.md
180touch ~/.gstack/.writing-style-prompted
low line 189

Access to hidden dotfiles in home directory

SourceSKILL.md
189touch ~/.gstack/.completeness-intro-seen
medium line 202

Access to hidden dotfiles in home directory

SourceSKILL.md
202If A: run `~/.claude/skills/gstack/bin/gstack-config set telemetry community`
medium line 212

Access to hidden dotfiles in home directory

SourceSKILL.md
212If B→A: run `~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous`
medium line 213

Access to hidden dotfiles in home directory

SourceSKILL.md
213If B→B: run `~/.claude/skills/gstack/bin/gstack-config set telemetry off`
low line 217

Access to hidden dotfiles in home directory

SourceSKILL.md
217touch ~/.gstack/.telemetry-prompted
medium line 230

Access to hidden dotfiles in home directory

SourceSKILL.md
230If A: run `~/.claude/skills/gstack/bin/gstack-config set proactive true`
medium line 231

Access to hidden dotfiles in home directory

SourceSKILL.md
231If B: run `~/.claude/skills/gstack/bin/gstack-config set proactive false`
low line 235

Access to hidden dotfiles in home directory

SourceSKILL.md
235touch ~/.gstack/.proactive-prompted
medium line 277

Access to hidden dotfiles in home directory

SourceSKILL.md
277If B: run `~/.claude/skills/gstack/bin/gstack-config set routing_declined true` and say they can re-enable with `gstack-config set routing_declined false`.
medium line 281

Access to hidden dotfiles in home directory

SourceSKILL.md
281If `VENDORED_GSTACK` is `yes`, warn once via AskUserQuestion unless `~/.gstack/.vendoring-warned-$SLUG` exists:
medium line 293

Access to hidden dotfiles in home directory

SourceSKILL.md
2933. Run `~/.claude/skills/gstack/bin/gstack-team-init required` (or `optional`)
medium line 295

Access to hidden dotfiles in home directory

SourceSKILL.md
2955. Tell the user: "Done. Each developer now runs: `cd ~/.claude/skills/gstack && ./setup --team`"
low line 301

Access to hidden dotfiles in home directory

SourceSKILL.md
301eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
low line 302

Access to hidden dotfiles in home directory

SourceSKILL.md
302touch ~/.gstack/.vendoring-warned-${SLUG:-unknown}
low line 444

Access to hidden dotfiles in home directory

SourceSKILL.md
444_BRAIN_SYNC_BIN="~/.claude/skills/gstack/bin/gstack-brain-sync"
low line 445

Access to hidden dotfiles in home directory

SourceSKILL.md
445_BRAIN_CONFIG_BIN="~/.claude/skills/gstack/bin/gstack-config"
medium line 549

Access to hidden dotfiles in home directory

SourceSKILL.md
549If A/B and `~/.gstack/.git` is missing, ask whether to run `gstack-artifacts-init`. Do not block the skill.
low line 554

Access to hidden dotfiles in home directory

SourceSKILL.md
554"~/.claude/skills/gstack/bin/gstack-brain-sync" --discover-new 2>/dev/null || true
low line 555

Access to hidden dotfiles in home directory

SourceSKILL.md
555"~/.claude/skills/gstack/bin/gstack-brain-sync" --once 2>/dev/null || true
low line 598

Access to hidden dotfiles in home directory

SourceSKILL.md
598eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)"
low line 615

Access to hidden dotfiles in home directory

SourceSKILL.md
615~/.claude/skills/gstack/bin/gstack-decision-search --recent 5 2>/dev/null
medium line 624

Access to hidden dotfiles in home directory

SourceSKILL.md
624**Cross-session decisions.** If `ACTIVE DECISIONS` are listed, treat them as prior settled calls with their rationale — do not silently re-litigate them; if you're about to reverse one, say so explici
medium line 637

Access to hidden dotfiles in home directory

SourceSKILL.md
637Curated jargon list lives at `~/.claude/skills/gstack/scripts/jargon-list.json` (80+ terms). On the first jargon term you encounter this session, Read that file once; treat the `terms` array as the ca
medium line 683

Access to hidden dotfiles in home directory

SourceSKILL.md
683Before each AskUserQuestion, choose `question_id` from `scripts/question-registry.ts` or `{skill}-{slug}`, then run `~/.claude/skills/gstack/bin/gstack-question-preference --check "<id>"`. `AUTO_DECID
low line 691

Access to hidden dotfiles in home directory

SourceSKILL.md
691~/.claude/skills/gstack/bin/gstack-question-log '{"skill":"retro","question_id":"<id>","question_summary":"<short>","category":"<approval|clarification|routing|cherry-pick|feedback-loop>","door_type":
low line 700

Access to hidden dotfiles in home directory

SourceSKILL.md
700~/.claude/skills/gstack/bin/gstack-question-preference --write '{"question_id":"<id>","preference":"<pref>","source":"inline-user","free_text":"<optional original words>"}'
low line 720

Access to hidden dotfiles in home directory

SourceSKILL.md
720~/.claude/skills/gstack/bin/gstack-learnings-log '{"skill":"SKILL_NAME","type":"operational","key":"SHORT_KEY","insight":"DESCRIPTION","confidence":N,"source":"observed"}'
medium line 730

Access to hidden dotfiles in home directory

SourceSKILL.md
730`~/.gstack/analytics/`, matching preamble analytics writes.
low line 737

Access to hidden dotfiles in home directory

SourceSKILL.md
737rm -f ~/.gstack/analytics/.pending-"$_SESSION_ID" 2>/dev/null || true
low line 739

Access to hidden dotfiles in home directory

SourceSKILL.md
739~/.claude/skills/gstack/bin/gstack-timeline-log '{"skill":"SKILL_NAME","event":"completed","branch":"'$(git branch --show-current 2>/dev/null || echo unknown)'","outcome":"OUTCOME","duration_s":"'"$_T
low line 742

Access to hidden dotfiles in home directory

SourceSKILL.md
742echo '{"skill":"SKILL_NAME","duration_s":"'"$_TEL_DUR"'","outcome":"OUTCOME","browse":"USED_BROWSE","session":"'"$_SESSION_ID"'","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"}' >> ~/.gstack/analytics/skill-
low line 745

Access to hidden dotfiles in home directory

SourceSKILL.md
745if [ "$_TEL" != "off" ] && [ -x ~/.claude/skills/gstack/bin/gstack-telemetry-log ]; then
low line 746

Access to hidden dotfiles in home directory

SourceSKILL.md
746~/.claude/skills/gstack/bin/gstack-telemetry-log \
low line 842

Access to hidden dotfiles in home directory

SourceSKILL.md
842_CROSS_PROJ=$(~/.claude/skills/gstack/bin/gstack-config get cross_project_learnings 2>/dev/null || echo "unset")
low line 845

Access to hidden dotfiles in home directory

SourceSKILL.md
845~/.claude/skills/gstack/bin/gstack-learnings-search --limit 10 --cross-project 2>/dev/null || true
low line 847

Access to hidden dotfiles in home directory

SourceSKILL.md
847~/.claude/skills/gstack/bin/gstack-learnings-search --limit 10 2>/dev/null || true
medium line 862

Access to hidden dotfiles in home directory

SourceSKILL.md
862If A: run `~/.claude/skills/gstack/bin/gstack-config set cross_project_learnings true`
medium line 863

Access to hidden dotfiles in home directory

SourceSKILL.md
863If B: run `~/.claude/skills/gstack/bin/gstack-config set cross_project_learnings false`
low line 880

Access to hidden dotfiles in home directory

SourceSKILL.md
880[ -f ~/.gstack/retro-context.md ] && echo "RETRO_CONTEXT_FOUND" || echo "NO_RETRO_CONTEXT"
medium line 883

Access to hidden dotfiles in home directory

SourceSKILL.md
883If `RETRO_CONTEXT_FOUND`: read `~/.gstack/retro-context.md`. This file is user-authored and may contain meeting notes, calendar events, decisions, and other context that doesn't appear in git history.
low line 981

Access to hidden dotfiles in home directory

SourceSKILL.md
981cat ~/.gstack/greptile-history.md 2>/dev/null || true
low line 993

Access to hidden dotfiles in home directory

SourceSKILL.md
993cat ~/.gstack/analytics/skill-usage.jsonl 2>/dev/null || true
medium line 1040

Access to hidden dotfiles in home directory

SourceSKILL.md
1040**Greptile signal (if history exists):** Read `~/.gstack/greptile-history.md` (fetched in Step 1, command 8). Filter entries within the retro time window by date. Count entries by type: `fix`, `fp`, `
medium line 1056

Access to hidden dotfiles in home directory

SourceSKILL.md
1056**Skill Usage (if analytics exist):** Read `~/.gstack/analytics/skill-usage.jsonl` if it exists. Filter entries within the retro time window by `ts` field. Separate skill activations (no `event` field
medium line 1064

Access to hidden dotfiles in home directory

SourceSKILL.md
1064**Eureka Moments (if logged):** Read `~/.gstack/analytics/eureka.jsonl` if it exists. Filter entries within the retro time window by `ts` field. For each eureka moment, show the skill that flagged it,
low line 1176

Access to hidden dotfiles in home directory

SourceSKILL.md
1176~/.claude/skills/gstack/bin/gstack-learnings-log '{"skill":"retro","type":"TYPE","key":"SHORT_KEY","insight":"DESCRIPTION","confidence":N,"source":"SOURCE","files":["path/to/relevant/file"]}'
medium line 1302

Access to hidden dotfiles in home directory

SourceSKILL.md
1302**Note:** Only include the `greptile` field if `~/.gstack/greptile-history.md` exists and has entries within the time window. Only include the `backlog` field if `TODOS.md` exists. Only include the `t
low line 1379

Access to hidden dotfiles in home directory

SourceSKILL.md
1379eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)"
low line 1380

Access to hidden dotfiles in home directory

SourceSKILL.md
1380cat ~/.gstack/projects/$SLUG/*-reviews.jsonl 2>/dev/null | grep '"skill":"ship"' | grep '"plan_items_total"' || echo "NO_PLAN_DATA"
low line 1462

Access to hidden dotfiles in home directory

SourceSKILL.md
1462[ -x ~/.claude/skills/gstack/bin/gstack-global-discover ] && DISCOVER_BIN=~/.claude/skills/gstack/bin/gstack-global-discover
low line 1681

Access to hidden dotfiles in home directory

SourceSKILL.md
1681ls -t ~/.gstack/retros/global-*.json 2>/dev/null | head -5
low line 1693

Access to hidden dotfiles in home directory

SourceSKILL.md
1693mkdir -p ~/.gstack/retros
low line 1700

Access to hidden dotfiles in home directory

SourceSKILL.md
1700existing=$(ls ~/.gstack/retros/global-${today}-*.json 2>/dev/null | wc -l | tr -d ' ')
medium line 1704

Access to hidden dotfiles in home directory

SourceSKILL.md
1704Use the Write tool to save JSON to `~/.gstack/retros/global-${today}-${next}.json`:
medium line 1770

Access to hidden dotfiles in home directory

SourceSKILL.md
1770- **Global mode:** Does NOT require being inside a git repo. Saves snapshots to `~/.gstack/retros/` (not `.context/retros/`). Gracefully skip AI tools that aren't installed. Only compare against prior
low line 185

External URL reference

SourceSKILL.md
185If `LAKE_INTRO` is `no`: say "gstack follows the **Boil the Ocean** principle — do the complete thing when AI makes marginal cost near-zero. Read more: https://garryslist.org/posts/boil-the-ocean" Off
low line 188

External URL reference

SourceSKILL.md
188open https://garryslist.org/posts/boil-the-ocean
Scanned on Jun 10, 2026
View Security Dashboard
Installation guide →
GitHub Stars 104.9K
Rate this skill
Categorysales
UpdatedJune 10, 2026
claudeclaude-codecopilotcodexclinefrontenddesignstripedocxgitapitestingdevopsbackendsdrproduct-managergrowth-pmtechnical-pmqa-engineersalesproductdevelopment
garrytan/gstack