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 May 12, 2026 and we found 100 security issues across 4 threat categories, including 1 high-severity. Review the findings below before installing.

Categories Tested

Security Issues

medium line 46

Template literal with variable interpolation in command context

SourceSKILL.md
46```bash
medium line 279

Template literal with variable interpolation in command context

SourceSKILL.md
279```bash
medium line 375

Template literal with variable interpolation in command context

SourceSKILL.md
375```bash
medium line 409

Template literal with variable interpolation in command context

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

Template literal with variable interpolation in command context

SourceSKILL.md
537```bash
medium line 1204

Template literal with variable interpolation in command context

SourceSKILL.md
1204```bash
medium line 1648

Template literal with variable interpolation in command context

SourceSKILL.md
1648```bash
high line 1655

Template literal with variable interpolation in command context

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
49mkdir -p ~/.gstack/sessions
low line 50

Access to hidden dotfiles in home directory

SourceSKILL.md
50touch ~/.gstack/sessions/"$PPID"
low line 51

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
77mkdir -p ~/.gstack/analytics
low line 79

Access to hidden dotfiles in home directory

SourceSKILL.md
79echo '{"skill":"retro","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","repo":"'$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null || echo "unknown")'"}' >> ~/.gstack/analytics/skill-usage
low line 81

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
84~/.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 90

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
126In 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 134

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
136If 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 141

Access to hidden dotfiles in home directory

SourceSKILL.md
141- 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 142

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
159rm -f ~/.gstack/.writing-style-prompt-pending
low line 160

Access to hidden dotfiles in home directory

SourceSKILL.md
160touch ~/.gstack/.writing-style-prompted
low line 169

Access to hidden dotfiles in home directory

SourceSKILL.md
169touch ~/.gstack/.completeness-intro-seen
medium line 182

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
197touch ~/.gstack/.telemetry-prompted
medium line 210

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
215touch ~/.gstack/.proactive-prompted
medium line 256

Access to hidden dotfiles in home directory

SourceSKILL.md
256If 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 260

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
538eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)"
medium line 693

Access to hidden dotfiles in home directory

SourceSKILL.md
693Before 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 697

Access to hidden dotfiles in home directory

SourceSKILL.md
697~/.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 706

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
736`~/.gstack/analytics/`, matching preamble analytics writes.
low line 743

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
745~/.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 748

Access to hidden dotfiles in home directory

SourceSKILL.md
748echo '{"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 751

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
752~/.claude/skills/gstack/bin/gstack-telemetry-log \
medium line 762

Access to hidden dotfiles in home directory

SourceSKILL.md
762In plan mode before ExitPlanMode: if the plan file lacks `## GSTACK REVIEW REPORT`, run `~/.claude/skills/gstack/bin/gstack-review-read` and append the standard runs/status/findings table. With `NO_RE
low line 850

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
891If `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 932

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
991**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 1007

Access to hidden dotfiles in home directory

SourceSKILL.md
1007**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 1015

Access to hidden dotfiles in home directory

SourceSKILL.md
1015**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 1127

Access to hidden dotfiles in home directory

SourceSKILL.md
1127~/.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 1253

Access to hidden dotfiles in home directory

SourceSKILL.md
1253**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 1330

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
1644mkdir -p ~/.gstack/retros
low line 1651

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
1721- **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 346

Unicode escape sequences

SourceSKILL.md
346writes `\u3103` thinking it is 管 U+7BA1, but `\u3103` is
low line 165

External URL reference

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

External URL reference

SourceSKILL.md
168open https://garryslist.org/posts/boil-the-ocean
Scanned on May 12, 2026
View Security Dashboard
Installation guide →
GitHub Stars 92.6K
Rate this skill
Categorysales
UpdatedMay 13, 2026
claudeclaude-codecopilotcodexclinefrontenddesignstripedocxgitapidatabasetestingdevopsbackendsdrproduct-managergrowth-pmtechnical-pmqa-engineersalesproductdevelopment
garrytan/gstack