Skip to main content

investigate

Facilitates systematic debugging and root cause analysis through a structured four-phase approach for effective issue resolution.

Install this skill

or
0/100

Security score

The investigate skill was audited on Jun 10, 2026 and we found 86 security issues across 3 threat categories. Review the findings below before installing.

Categories Tested

Security Issues

medium line 72

Template literal with variable interpolation in command context

SourceSKILL.md
72```bash
medium line 322

Template literal with variable interpolation in command context

SourceSKILL.md
322```bash
medium line 457

Template literal with variable interpolation in command context

SourceSKILL.md
457```bash
medium line 491

Template literal with variable interpolation in command context

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

Template literal with variable interpolation in command context

SourceSKILL.md
619```bash
medium line 870

Template literal with variable interpolation in command context

SourceSKILL.md
870```bash
medium line 47

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
52glob: "~/.gstack/analytics/eureka.jsonl"
low line 73

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
75mkdir -p ~/.gstack/sessions
low line 76

Access to hidden dotfiles in home directory

SourceSKILL.md
76touch ~/.gstack/sessions/"$PPID"
low line 77

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
106mkdir -p ~/.gstack/analytics
low line 108

Access to hidden dotfiles in home directory

SourceSKILL.md
108echo '{"skill":"investigate","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:-unk
low line 110

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
113~/.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 119

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
168In 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 176

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
178If 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 183

Access to hidden dotfiles in home directory

SourceSKILL.md
183- 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 184

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
201rm -f ~/.gstack/.writing-style-prompt-pending
low line 202

Access to hidden dotfiles in home directory

SourceSKILL.md
202touch ~/.gstack/.writing-style-prompted
low line 211

Access to hidden dotfiles in home directory

SourceSKILL.md
211touch ~/.gstack/.completeness-intro-seen
medium line 224

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
239touch ~/.gstack/.telemetry-prompted
medium line 252

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
257touch ~/.gstack/.proactive-prompted
medium line 299

Access to hidden dotfiles in home directory

SourceSKILL.md
299If 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 303

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
646**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 659

Access to hidden dotfiles in home directory

SourceSKILL.md
659Curated 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 705

Access to hidden dotfiles in home directory

SourceSKILL.md
705Before 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 713

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
752`~/.gstack/analytics/`, matching preamble analytics writes.
low line 759

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
761~/.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 764

Access to hidden dotfiles in home directory

SourceSKILL.md
764echo '{"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 767

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
768~/.claude/skills/gstack/bin/gstack-telemetry-log \
low line 815

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
818~/.claude/skills/gstack/bin/gstack-learnings-search --limit 10 --query "debug investigation root cause hypothesis bug fix" --cross-project 2>/dev/null || true
low line 820

Access to hidden dotfiles in home directory

SourceSKILL.md
820~/.claude/skills/gstack/bin/gstack-learnings-search --limit 10 --query "debug investigation root cause hypothesis bug fix" 2>/dev/null || true
medium line 835

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

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

Access to hidden dotfiles in home directory

SourceSKILL.md
859~/.claude/skills/gstack/bin/gstack-learnings-search --query "<your-keyword>" --limit 5 2>/dev/null || true
low line 879

Access to hidden dotfiles in home directory

SourceSKILL.md
879eval "$(~/.claude/skills/gstack/bin/gstack-paths)"
low line 991

Access to hidden dotfiles in home directory

SourceSKILL.md
991~/.claude/skills/gstack/bin/gstack-learnings-log '{"skill":"investigate","type":"investigation","key":"ROOT_CAUSE_KEY","insight":"ROOT_CAUSE_SUMMARY","confidence":9,"source":"observed","files":["affec
low line 1000

Access to hidden dotfiles in home directory

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

External URL reference

SourceSKILL.md
207If `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 210

External URL reference

SourceSKILL.md
210open 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-codecodexclinefrontenddesigndocxgitapidatabasetestingdevopsbackendsdrsales-engineercustomer-success-managertechnical-supportqa-engineersalessupportdevelopment
garrytan/gstack