feat: add (gstack) tag to skill descriptions for discoverability (#594)

Every SKILL.md.tmpl description now contains "gstack" on the last line,
making skills findable in Claude Code's command palette. First-line hooks
stay under 120 chars. Split ship description to fix wrapping.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Garry Tan
2026-03-28 22:32:30 -07:00
parent a38f9c9282
commit 0c56ae9268
54 changed files with 60 additions and 56 deletions
+1 -1
View File
@@ -6,7 +6,7 @@ description: |
Fast headless browser for QA testing and site dogfooding. Navigate pages, interact with
elements, verify state, diff before/after, take annotated screenshots, test responsive
layouts, forms, uploads, dialogs, and capture bug evidence. Use when asked to open or
test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots.
test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -6,7 +6,7 @@ description: |
Fast headless browser for QA testing and site dogfooding. Navigate pages, interact with
elements, verify state, diff before/after, take annotated screenshots, test responsive
layouts, forms, uploads, dialogs, and capture bug evidence. Use when asked to open or
test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots.
test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -10,7 +10,7 @@ description: |
Use when asked to "auto review", "autoplan", "run all reviews", "review this plan
automatically", or "make the decisions for me".
Proactively suggest when the user has a plan file and wants to run the full review
gauntlet without answering 15-30 intermediate questions.
gauntlet without answering 15-30 intermediate questions. (gstack)
benefits-from: [office-hours]
allowed-tools:
- Bash
+1 -1
View File
@@ -10,7 +10,7 @@ description: |
Use when asked to "auto review", "autoplan", "run all reviews", "review this plan
automatically", or "make the decisions for me".
Proactively suggest when the user has a plan file and wants to run the full review
gauntlet without answering 15-30 intermediate questions.
gauntlet without answering 15-30 intermediate questions. (gstack)
benefits-from: [office-hours]
allowed-tools:
- Bash
+1 -1
View File
@@ -7,7 +7,7 @@ description: |
baselines for page load times, Core Web Vitals, and resource sizes.
Compares before/after on every PR. Tracks performance trends over time.
Use when: "performance", "benchmark", "page speed", "lighthouse", "web vitals",
"bundle size", "load time".
"bundle size", "load time". (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -7,7 +7,7 @@ description: |
baselines for page load times, Core Web Vitals, and resource sizes.
Compares before/after on every PR. Tracks performance trends over time.
Use when: "performance", "benchmark", "page speed", "lighthouse", "web vitals",
"bundle size", "load time".
"bundle size", "load time". (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -8,7 +8,7 @@ description: |
responsive layouts, test forms and uploads, handle dialogs, and assert element states.
~100ms per command. Use when you need to test a feature, verify a deployment, dogfood a
user flow, or file a bug with evidence. Use when asked to "open in browser", "test the
site", "take a screenshot", or "dogfood this".
site", "take a screenshot", or "dogfood this". (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -8,7 +8,7 @@ description: |
responsive layouts, test forms and uploads, handle dialogs, and assert element states.
~100ms per command. Use when you need to test a feature, verify a deployment, dogfood a
user flow, or file a bug with evidence. Use when asked to "open in browser", "test the
site", "take a screenshot", or "dogfood this".
site", "take a screenshot", or "dogfood this". (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -7,7 +7,7 @@ description: |
performance regressions, and page failures using the browse daemon. Takes
periodic screenshots, compares against pre-deploy baselines, and alerts
on anomalies. Use when: "monitor deploy", "canary", "post-deploy check",
"watch production", "verify deploy".
"watch production", "verify deploy". (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -7,7 +7,7 @@ description: |
performance regressions, and page failures using the browse daemon. Takes
periodic screenshots, compares against pre-deploy baselines, and alerts
on anomalies. Use when: "monitor deploy", "canary", "post-deploy check",
"watch production", "verify deploy".
"watch production", "verify deploy". (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -6,7 +6,7 @@ description: |
force-push, git reset --hard, kubectl delete, and similar destructive operations.
User can override each warning. Use when touching prod, debugging live systems,
or working in a shared environment. Use when asked to "be careful", "safety mode",
"prod mode", or "careful mode".
"prod mode", or "careful mode". (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -6,7 +6,7 @@ description: |
force-push, git reset --hard, kubectl delete, and similar destructive operations.
User can override each warning. Use when touching prod, debugging live systems,
or working in a shared environment. Use when asked to "be careful", "safety mode",
"prod mode", or "careful mode".
"prod mode", or "careful mode". (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -7,7 +7,7 @@ description: |
codex review with pass/fail gate. Challenge: adversarial mode that tries to break
your code. Consult: ask codex anything with session continuity for follow-ups.
The "200 IQ autistic developer" second opinion. Use when asked to "codex review",
"codex challenge", "ask codex", "second opinion", or "consult codex".
"codex challenge", "ask codex", "second opinion", or "consult codex". (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -7,7 +7,7 @@ description: |
codex review with pass/fail gate. Challenge: adversarial mode that tries to break
your code. Consult: ask codex anything with session continuity for follow-ups.
The "200 IQ autistic developer" second opinion. Use when asked to "codex review",
"codex challenge", "ask codex", "second opinion", or "consult codex".
"codex challenge", "ask codex", "second opinion", or "consult codex". (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -8,7 +8,7 @@ description: |
scanning, plus OWASP Top 10, STRIDE threat modeling, and active verification.
Two modes: daily (zero-noise, 8/10 confidence gate) and comprehensive (monthly deep
scan, 2/10 bar). Trend tracking across audit runs.
Use when: "security audit", "threat model", "pentest review", "OWASP", "CSO review".
Use when: "security audit", "threat model", "pentest review", "OWASP", "CSO review". (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -8,7 +8,7 @@ description: |
scanning, plus OWASP Top 10, STRIDE threat modeling, and active verification.
Two modes: daily (zero-noise, 8/10 confidence gate) and comprehensive (monthly deep
scan, 2/10 bar). Trend tracking across audit runs.
Use when: "security audit", "threat model", "pentest review", "OWASP", "CSO review".
Use when: "security audit", "threat model", "pentest review", "OWASP", "CSO review". (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -9,7 +9,7 @@ description: |
of truth. For existing sites, use /plan-design-review to infer the system instead.
Use when asked to "design system", "brand guidelines", or "create DESIGN.md".
Proactively suggest when starting a new project's UI with no existing
design system or DESIGN.md.
design system or DESIGN.md. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -9,7 +9,7 @@ description: |
of truth. For existing sites, use /plan-design-review to infer the system instead.
Use when asked to "design system", "brand guidelines", or "create DESIGN.md".
Proactively suggest when starting a new project's UI with no existing
design system or DESIGN.md.
design system or DESIGN.md. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -9,7 +9,7 @@ description: |
screenshots. For plan-mode design review (before implementation), use /plan-design-review.
Use when asked to "audit the design", "visual QA", "check if it looks good", or "design polish".
Proactively suggest when the user mentions visual inconsistencies or
wants to polish the look of a live site.
wants to polish the look of a live site. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -9,7 +9,7 @@ description: |
screenshots. For plan-mode design review (before implementation), use /plan-design-review.
Use when asked to "audit the design", "visual QA", "check if it looks good", or "design polish".
Proactively suggest when the user mentions visual inconsistencies or
wants to polish the look of a live site.
wants to polish the look of a live site. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -8,7 +8,7 @@ description: |
run anytime. Use when: "explore designs", "show me options", "design variants",
"visual brainstorm", or "I don't like how this looks".
Proactively suggest when the user describes a UI feature but hasn't seen
what it could look like.
what it could look like. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -8,7 +8,7 @@ description: |
run anytime. Use when: "explore designs", "show me options", "design variants",
"visual brainstorm", or "I don't like how this looks".
Proactively suggest when the user describes a UI feature but hasn't seen
what it could look like.
what it could look like. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -7,7 +7,7 @@ description: |
diff, updates README/ARCHITECTURE/CONTRIBUTING/CLAUDE.md to match what shipped,
polishes CHANGELOG voice, cleans up TODOS, and optionally bumps VERSION. Use when
asked to "update the docs", "sync documentation", or "post-ship docs".
Proactively suggest after a PR is merged or code is shipped.
Proactively suggest after a PR is merged or code is shipped. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -7,7 +7,7 @@ description: |
diff, updates README/ARCHITECTURE/CONTRIBUTING/CLAUDE.md to match what shipped,
polishes CHANGELOG voice, cleans up TODOS, and optionally bumps VERSION. Use when
asked to "update the docs", "sync documentation", or "post-ship docs".
Proactively suggest after a PR is merged or code is shipped.
Proactively suggest after a PR is merged or code is shipped. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -6,7 +6,7 @@ description: |
Write outside the allowed path. Use when debugging to prevent accidentally
"fixing" unrelated code, or when you want to scope changes to one module.
Use when asked to "freeze", "restrict edits", "only edit this folder",
or "lock down edits".
or "lock down edits". (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -6,7 +6,7 @@ description: |
Write outside the allowed path. Use when debugging to prevent accidentally
"fixing" unrelated code, or when you want to scope changes to one module.
Use when asked to "freeze", "restrict edits", "only edit this folder",
or "lock down edits".
or "lock down edits". (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -6,7 +6,7 @@ description: |
Combines /careful (warns before rm -rf, DROP TABLE, force-push, etc.) with
/freeze (blocks edits outside a specified directory). Use for maximum safety
when touching prod or debugging live systems. Use when asked to "guard mode",
"full safety", "lock it down", or "maximum safety".
"full safety", "lock it down", or "maximum safety". (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -6,7 +6,7 @@ description: |
Combines /careful (warns before rm -rf, DROP TABLE, force-push, etc.) with
/freeze (blocks edits outside a specified directory). Use for maximum safety
when touching prod or debugging live systems. Use when asked to "guard mode",
"full safety", "lock it down", or "maximum safety".
"full safety", "lock it down", or "maximum safety". (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -8,7 +8,7 @@ description: |
Use when asked to "debug this", "fix this bug", "why is this broken",
"investigate this error", or "root cause analysis".
Proactively suggest when the user reports errors, unexpected behavior, or
is troubleshooting why something stopped working.
is troubleshooting why something stopped working. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -8,7 +8,7 @@ description: |
Use when asked to "debug this", "fix this bug", "why is this broken",
"investigate this error", or "root cause analysis".
Proactively suggest when the user reports errors, unexpected behavior, or
is troubleshooting why something stopped working.
is troubleshooting why something stopped working. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -6,7 +6,7 @@ description: |
Land and deploy workflow. Merges the PR, waits for CI and deploy,
verifies production health via canary checks. Takes over after /ship
creates the PR. Use when: "merge", "land", "deploy", "merge and verify",
"land it", "ship it to production".
"land it", "ship it to production". (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -6,7 +6,7 @@ description: |
Land and deploy workflow. Merges the PR, waits for CI and deploy,
verifies production health via canary checks. Takes over after /ship
creates the PR. Use when: "merge", "land", "deploy", "merge and verify",
"land it", "ship it to production".
"land it", "ship it to production". (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -11,7 +11,7 @@ description: |
this", "office hours", or "is this worth building".
Proactively suggest when the user describes a new product idea or is exploring
whether something is worth building — before any code is written.
Use before /plan-ceo-review or /plan-eng-review.
Use before /plan-ceo-review or /plan-eng-review. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -11,7 +11,7 @@ description: |
this", "office hours", or "is this worth building".
Proactively suggest when the user describes a new product idea or is exploring
whether something is worth building — before any code is written.
Use before /plan-ceo-review or /plan-eng-review.
Use before /plan-ceo-review or /plan-eng-review. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -10,7 +10,7 @@ description: |
Use when asked to "think bigger", "expand scope", "strategy review", "rethink this",
or "is this ambitious enough".
Proactively suggest when the user is questioning scope or ambition of a plan,
or when the plan feels like it could be thinking bigger.
or when the plan feels like it could be thinking bigger. (gstack)
benefits-from: [office-hours]
allowed-tools:
- Read
+1 -1
View File
@@ -10,7 +10,7 @@ description: |
Use when asked to "think bigger", "expand scope", "strategy review", "rethink this",
or "is this ambitious enough".
Proactively suggest when the user is questioning scope or ambition of a plan,
or when the plan feels like it could be thinking bigger.
or when the plan feels like it could be thinking bigger. (gstack)
benefits-from: [office-hours]
allowed-tools:
- Read
+1 -1
View File
@@ -9,7 +9,7 @@ description: |
visual audits, use /design-review. Use when asked to "review the design plan"
or "design critique".
Proactively suggest when the user has a plan with UI/UX components that
should be reviewed before implementation.
should be reviewed before implementation. (gstack)
allowed-tools:
- Read
- Edit
+1 -1
View File
@@ -9,7 +9,7 @@ description: |
visual audits, use /design-review. Use when asked to "review the design plan"
or "design critique".
Proactively suggest when the user has a plan with UI/UX components that
should be reviewed before implementation.
should be reviewed before implementation. (gstack)
allowed-tools:
- Read
- Edit
+1 -1
View File
@@ -8,7 +8,7 @@ description: |
issues interactively with opinionated recommendations. Use when asked to
"review the architecture", "engineering review", or "lock in the plan".
Proactively suggest when the user has a plan or design doc and is about to
start coding — to catch architecture issues before implementation.
start coding — to catch architecture issues before implementation. (gstack)
benefits-from: [office-hours]
allowed-tools:
- Read
+1 -1
View File
@@ -8,7 +8,7 @@ description: |
issues interactively with opinionated recommendations. Use when asked to
"review the architecture", "engineering review", or "lock in the plan".
Proactively suggest when the user has a plan or design doc and is about to
start coding — to catch architecture issues before implementation.
start coding — to catch architecture issues before implementation. (gstack)
benefits-from: [office-hours]
allowed-tools:
- Read
+1 -1
View File
@@ -7,7 +7,7 @@ description: |
structured report with health score, screenshots, and repro steps — but never
fixes anything. Use when asked to "just report bugs", "qa report only", or
"test but don't fix". For the full test-fix-verify loop, use /qa instead.
Proactively suggest when the user wants a bug report without any code changes.
Proactively suggest when the user wants a bug report without any code changes. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -7,7 +7,7 @@ description: |
structured report with health score, screenshots, and repro steps — but never
fixes anything. Use when asked to "just report bugs", "qa report only", or
"test but don't fix". For the full test-fix-verify loop, use /qa instead.
Proactively suggest when the user wants a bug report without any code changes.
Proactively suggest when the user wants a bug report without any code changes. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -10,7 +10,7 @@ description: |
Proactively suggest when the user says a feature is ready for testing
or asks "does this work?". Three tiers: Quick (critical/high only),
Standard (+ medium), Exhaustive (+ cosmetic). Produces before/after health scores,
fix evidence, and a ship-readiness summary. For report-only mode, use /qa-only.
fix evidence, and a ship-readiness summary. For report-only mode, use /qa-only. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -10,7 +10,7 @@ description: |
Proactively suggest when the user says a feature is ready for testing
or asks "does this work?". Three tiers: Quick (critical/high only),
Standard (+ medium), Exhaustive (+ cosmetic). Produces before/after health scores,
fix evidence, and a ship-readiness summary. For report-only mode, use /qa-only.
fix evidence, and a ship-readiness summary. For report-only mode, use /qa-only. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -7,7 +7,7 @@ description: |
and code quality metrics with persistent history and trend tracking.
Team-aware: breaks down per-person contributions with praise and growth areas.
Use when asked to "weekly retro", "what did we ship", or "engineering retrospective".
Proactively suggest at the end of a work week or sprint.
Proactively suggest at the end of a work week or sprint. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -7,7 +7,7 @@ description: |
and code quality metrics with persistent history and trend tracking.
Team-aware: breaks down per-person contributions with praise and growth areas.
Use when asked to "weekly retro", "what did we ship", or "engineering retrospective".
Proactively suggest at the end of a work week or sprint.
Proactively suggest at the end of a work week or sprint. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -6,7 +6,7 @@ description: |
Pre-landing PR review. Analyzes diff against the base branch for SQL safety, LLM trust
boundary violations, conditional side effects, and other structural issues. Use when
asked to "review this PR", "code review", "pre-landing review", or "check my diff".
Proactively suggest when the user is about to merge or land code changes.
Proactively suggest when the user is about to merge or land code changes. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -6,7 +6,7 @@ description: |
Pre-landing PR review. Analyzes diff against the base branch for SQL safety, LLM trust
boundary violations, conditional side effects, and other structural issues. Use when
asked to "review this PR", "code review", "pre-landing review", or "check my diff".
Proactively suggest when the user is about to merge or land code changes.
Proactively suggest when the user is about to merge or land code changes. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -6,7 +6,7 @@ description: |
Import cookies from your real Chromium browser into the headless browse session.
Opens an interactive picker UI where you select which cookie domains to import.
Use before QA testing authenticated pages. Use when asked to "import cookies",
"login to the site", or "authenticate the browser".
"login to the site", or "authenticate the browser". (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -6,7 +6,7 @@ description: |
Import cookies from your real Chromium browser into the headless browse session.
Opens an interactive picker UI where you select which cookie domains to import.
Use before QA testing authenticated pages. Use when asked to "import cookies",
"login to the site", or "authenticate the browser".
"login to the site", or "authenticate the browser". (gstack)
allowed-tools:
- Bash
- Read
+4 -2
View File
@@ -3,8 +3,10 @@ name: ship
preamble-tier: 4
version: 1.0.0
description: |
Ship workflow: detect + merge base branch, run tests, review diff, bump VERSION, update CHANGELOG, commit, push, create PR. Use when asked to "ship", "deploy", "push to main", "create a PR", or "merge and push".
Proactively suggest when the user says code is ready or asks about deploying.
Ship workflow: detect + merge base branch, run tests, review diff, bump VERSION,
update CHANGELOG, commit, push, create PR. Use when asked to "ship", "deploy",
"push to main", "create a PR", or "merge and push".
Proactively suggest when the user says code is ready or asks about deploying. (gstack)
allowed-tools:
- Bash
- Read
+4 -2
View File
@@ -3,8 +3,10 @@ name: ship
preamble-tier: 4
version: 1.0.0
description: |
Ship workflow: detect + merge base branch, run tests, review diff, bump VERSION, update CHANGELOG, commit, push, create PR. Use when asked to "ship", "deploy", "push to main", "create a PR", or "merge and push".
Proactively suggest when the user says code is ready or asks about deploying.
Ship workflow: detect + merge base branch, run tests, review diff, bump VERSION,
update CHANGELOG, commit, push, create PR. Use when asked to "ship", "deploy",
"push to main", "create a PR", or "merge and push".
Proactively suggest when the user says code is ready or asks about deploying. (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -5,7 +5,7 @@ description: |
Clear the freeze boundary set by /freeze, allowing edits to all directories
again. Use when you want to widen edit scope without ending the session.
Use when asked to "unfreeze", "unlock edits", "remove freeze", or
"allow all edits".
"allow all edits". (gstack)
allowed-tools:
- Bash
- Read
+1 -1
View File
@@ -5,7 +5,7 @@ description: |
Clear the freeze boundary set by /freeze, allowing edits to all directories
again. Use when you want to widen edit scope without ending the session.
Use when asked to "unfreeze", "unlock edits", "remove freeze", or
"allow all edits".
"allow all edits". (gstack)
allowed-tools:
- Bash
- Read