From ddea3ad1b7d45807e2118cb4ffa1652c0b4c306f Mon Sep 17 00:00:00 2001 From: Garry Tan Date: Wed, 15 Apr 2026 00:35:49 -0700 Subject: [PATCH] feat: add triggers to all 38 skill templates Multi-word, skill-specific trigger keywords for GBrain's RESOLVER.md router. Each skill gets 3-6 triggers derived from its "Use when asked to..." description text. Avoids single generic words that would collide across skills (e.g., "debug this" not "debug"). These are distinct from voice-triggers (speech-to-text aliases) and serve GBrain's checkResolvable() validation. Co-Authored-By: Claude Opus 4.6 (1M context) --- SKILL.md.tmpl | 5 +++++ autoplan/SKILL.md.tmpl | 4 ++++ benchmark/SKILL.md.tmpl | 4 ++++ browse/SKILL.md.tmpl | 4 ++++ canary/SKILL.md.tmpl | 4 ++++ careful/SKILL.md.tmpl | 4 ++++ checkpoint/SKILL.md.tmpl | 4 ++++ codex/SKILL.md.tmpl | 4 ++++ contrib/add-host/SKILL.md.tmpl | 4 ++++ cso/SKILL.md.tmpl | 8 ++++++++ design-consultation/SKILL.md.tmpl | 8 ++++++++ design-html/SKILL.md.tmpl | 4 ++++ design-review/SKILL.md.tmpl | 8 ++++++++ design-shotgun/SKILL.md.tmpl | 4 ++++ devex-review/SKILL.md.tmpl | 4 ++++ document-release/SKILL.md.tmpl | 4 ++++ freeze/SKILL.md.tmpl | 4 ++++ gstack-upgrade/SKILL.md.tmpl | 4 ++++ guard/SKILL.md.tmpl | 4 ++++ health/SKILL.md.tmpl | 4 ++++ investigate/SKILL.md.tmpl | 6 ++++++ land-and-deploy/SKILL.md.tmpl | 4 ++++ learn/SKILL.md.tmpl | 4 ++++ office-hours/SKILL.md.tmpl | 5 +++++ open-gstack-browser/SKILL.md.tmpl | 4 ++++ pair-agent/SKILL.md.tmpl | 4 ++++ plan-ceo-review/SKILL.md.tmpl | 5 +++++ plan-design-review/SKILL.md.tmpl | 4 ++++ plan-devex-review/SKILL.md.tmpl | 4 ++++ plan-eng-review/SKILL.md.tmpl | 8 ++++++++ qa-only/SKILL.md.tmpl | 4 ++++ qa/SKILL.md.tmpl | 8 ++++++++ retro/SKILL.md.tmpl | 4 ++++ review/SKILL.md.tmpl | 5 +++++ setup-browser-cookies/SKILL.md.tmpl | 4 ++++ setup-deploy/SKILL.md.tmpl | 4 ++++ ship/SKILL.md.tmpl | 9 +++++++++ unfreeze/SKILL.md.tmpl | 4 ++++ 38 files changed, 183 insertions(+) diff --git a/SKILL.md.tmpl b/SKILL.md.tmpl index 1c8f12a86..3709c97c5 100644 --- a/SKILL.md.tmpl +++ b/SKILL.md.tmpl @@ -11,6 +11,11 @@ allowed-tools: - Bash - Read - AskUserQuestion +triggers: + - browse this page + - take a screenshot + - navigate to url + - inspect the page --- diff --git a/autoplan/SKILL.md.tmpl b/autoplan/SKILL.md.tmpl index 18868a3d2..ae3383ef7 100644 --- a/autoplan/SKILL.md.tmpl +++ b/autoplan/SKILL.md.tmpl @@ -15,6 +15,10 @@ voice-triggers: - "auto plan" - "automatic review" benefits-from: [office-hours] +triggers: + - run all reviews + - automatic review pipeline + - auto plan review allowed-tools: - Bash - Read diff --git a/benchmark/SKILL.md.tmpl b/benchmark/SKILL.md.tmpl index afedc1c30..038f16f5f 100644 --- a/benchmark/SKILL.md.tmpl +++ b/benchmark/SKILL.md.tmpl @@ -11,6 +11,10 @@ description: | voice-triggers: - "speed test" - "check performance" +triggers: + - performance benchmark + - check page speed + - detect performance regression allowed-tools: - Bash - Read diff --git a/browse/SKILL.md.tmpl b/browse/SKILL.md.tmpl index 83068d16e..5d4ba8fc1 100644 --- a/browse/SKILL.md.tmpl +++ b/browse/SKILL.md.tmpl @@ -9,6 +9,10 @@ description: | ~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". (gstack) +triggers: + - browse a page + - headless browser + - take page screenshot allowed-tools: - Bash - Read diff --git a/canary/SKILL.md.tmpl b/canary/SKILL.md.tmpl index 412183040..d1eb2950a 100644 --- a/canary/SKILL.md.tmpl +++ b/canary/SKILL.md.tmpl @@ -14,6 +14,10 @@ allowed-tools: - Write - Glob - AskUserQuestion +triggers: + - monitor after deploy + - canary check + - watch for errors post-deploy --- {{PREAMBLE}} diff --git a/careful/SKILL.md.tmpl b/careful/SKILL.md.tmpl index dd8f0ded1..9d83411f8 100644 --- a/careful/SKILL.md.tmpl +++ b/careful/SKILL.md.tmpl @@ -7,6 +7,10 @@ description: | 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". (gstack) +triggers: + - be careful + - warn before destructive + - safety mode allowed-tools: - Bash - Read diff --git a/checkpoint/SKILL.md.tmpl b/checkpoint/SKILL.md.tmpl index 8df8d6ea6..77c57d9e5 100644 --- a/checkpoint/SKILL.md.tmpl +++ b/checkpoint/SKILL.md.tmpl @@ -17,6 +17,10 @@ allowed-tools: - Glob - Grep - AskUserQuestion +triggers: + - save progress + - checkpoint this + - resume where i left off --- {{PREAMBLE}} diff --git a/codex/SKILL.md.tmpl b/codex/SKILL.md.tmpl index eac1d96ed..105b53831 100644 --- a/codex/SKILL.md.tmpl +++ b/codex/SKILL.md.tmpl @@ -12,6 +12,10 @@ voice-triggers: - "code x" - "code ex" - "get another opinion" +triggers: + - codex review + - second opinion + - outside voice challenge allowed-tools: - Bash - Read diff --git a/contrib/add-host/SKILL.md.tmpl b/contrib/add-host/SKILL.md.tmpl index 362714c3f..3fbddfa26 100644 --- a/contrib/add-host/SKILL.md.tmpl +++ b/contrib/add-host/SKILL.md.tmpl @@ -3,6 +3,10 @@ name: gstack-contrib-add-host description: | Contributor-only skill: create a new host config for gstack's multi-host system. NOT installed for end users. Only usable from the gstack source repo. +triggers: + - add new host + - create host config + - contribute new agent host --- # /gstack-contrib-add-host — Add a New Host diff --git a/cso/SKILL.md.tmpl b/cso/SKILL.md.tmpl index e12a690c2..2f849ee00 100644 --- a/cso/SKILL.md.tmpl +++ b/cso/SKILL.md.tmpl @@ -25,10 +25,16 @@ allowed-tools: - Agent - WebSearch - AskUserQuestion +triggers: + - security audit + - check for vulnerabilities + - owasp review --- {{PREAMBLE}} +{{GBRAIN_CONTEXT_LOAD}} + # /cso — Chief Security Officer Audit (v2) You are a **Chief Security Officer** who has led incident response on real breaches and testified before boards about security posture. You think like an attacker but report like a defender. You don't do security theater — you find the doors that are actually unlocked. @@ -609,6 +615,8 @@ If `.gstack/` is not in `.gitignore`, note it in findings — security reports s {{LEARNINGS_LOG}} +{{GBRAIN_SAVE_RESULTS}} + ## Important Rules - **Think like an attacker, report like a defender.** Show the exploit path, then the fix. diff --git a/design-consultation/SKILL.md.tmpl b/design-consultation/SKILL.md.tmpl index 247b63e20..d80c7fb26 100644 --- a/design-consultation/SKILL.md.tmpl +++ b/design-consultation/SKILL.md.tmpl @@ -19,6 +19,10 @@ allowed-tools: - Grep - AskUserQuestion - WebSearch +triggers: + - design system + - create a brand + - design from scratch --- {{PREAMBLE}} @@ -79,6 +83,8 @@ If `DESIGN_NOT_AVAILABLE`: Phase 5 falls back to the HTML preview page (still go --- +{{GBRAIN_CONTEXT_LOAD}} + {{LEARNINGS_SEARCH}} ## Phase 1: Product Context @@ -423,6 +429,8 @@ After shipping DESIGN.md, if the session produced screen-level mockups or page l {{LEARNINGS_LOG}} +{{GBRAIN_SAVE_RESULTS}} + ## Important Rules 1. **Propose, don't present menus.** You are a consultant, not a form. Make opinionated recommendations based on the product context, then let the user adjust. diff --git a/design-html/SKILL.md.tmpl b/design-html/SKILL.md.tmpl index 9fb422e9e..3cdec9a14 100644 --- a/design-html/SKILL.md.tmpl +++ b/design-html/SKILL.md.tmpl @@ -15,6 +15,10 @@ voice-triggers: - "build the design" - "code the mockup" - "make it real" +triggers: + - build the design + - code the mockup + - make design real allowed-tools: - Bash - Read diff --git a/design-review/SKILL.md.tmpl b/design-review/SKILL.md.tmpl index fbf59e8db..fab9bb39e 100644 --- a/design-review/SKILL.md.tmpl +++ b/design-review/SKILL.md.tmpl @@ -19,10 +19,16 @@ allowed-tools: - Grep - AskUserQuestion - WebSearch +triggers: + - visual design audit + - design qa + - fix design issues --- {{PREAMBLE}} +{{GBRAIN_CONTEXT_LOAD}} + # /design-review: Design Audit → Fix → Verify You are a senior product designer AND a frontend engineer. Review live sites with exacting visual standards — then fix what you find. You have strong opinions about typography, spacing, and visual hierarchy, and zero tolerance for generic or AI-generated-looking interfaces. @@ -293,6 +299,8 @@ If the repo has a `TODOS.md`: {{LEARNINGS_LOG}} +{{GBRAIN_SAVE_RESULTS}} + ## Additional Rules (design-review specific) 11. **Clean working tree required.** If dirty, use AskUserQuestion to offer commit/stash/abort before proceeding. diff --git a/design-shotgun/SKILL.md.tmpl b/design-shotgun/SKILL.md.tmpl index 26c339688..4842409d2 100644 --- a/design-shotgun/SKILL.md.tmpl +++ b/design-shotgun/SKILL.md.tmpl @@ -9,6 +9,10 @@ description: | "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. (gstack) +triggers: + - explore design variants + - show me design options + - visual design brainstorm allowed-tools: - Bash - Read diff --git a/devex-review/SKILL.md.tmpl b/devex-review/SKILL.md.tmpl index 1e0f9d6d3..081d4f35b 100644 --- a/devex-review/SKILL.md.tmpl +++ b/devex-review/SKILL.md.tmpl @@ -15,6 +15,10 @@ voice-triggers: - "test the developer experience" - "try the onboarding" - "developer experience test" +triggers: + - live dx audit + - test developer experience + - measure onboarding time allowed-tools: - Read - Edit diff --git a/document-release/SKILL.md.tmpl b/document-release/SKILL.md.tmpl index 4285525c2..0fd08eac7 100644 --- a/document-release/SKILL.md.tmpl +++ b/document-release/SKILL.md.tmpl @@ -16,6 +16,10 @@ allowed-tools: - Grep - Glob - AskUserQuestion +triggers: + - update docs after ship + - document what changed + - post-ship docs --- {{PREAMBLE}} diff --git a/freeze/SKILL.md.tmpl b/freeze/SKILL.md.tmpl index 42329c41c..85e646ed8 100644 --- a/freeze/SKILL.md.tmpl +++ b/freeze/SKILL.md.tmpl @@ -7,6 +7,10 @@ description: | "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". (gstack) +triggers: + - freeze edits to directory + - lock editing scope + - restrict file changes allowed-tools: - Bash - Read diff --git a/gstack-upgrade/SKILL.md.tmpl b/gstack-upgrade/SKILL.md.tmpl index af4bcd236..19f3a0d59 100644 --- a/gstack-upgrade/SKILL.md.tmpl +++ b/gstack-upgrade/SKILL.md.tmpl @@ -10,6 +10,10 @@ voice-triggers: - "update the tools" - "gee stack upgrade" - "g stack upgrade" +triggers: + - upgrade gstack + - update gstack version + - get latest gstack allowed-tools: - Bash - Read diff --git a/guard/SKILL.md.tmpl b/guard/SKILL.md.tmpl index fe385c98c..1f3c6575a 100644 --- a/guard/SKILL.md.tmpl +++ b/guard/SKILL.md.tmpl @@ -7,6 +7,10 @@ description: | /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". (gstack) +triggers: + - full safety mode + - guard against mistakes + - maximum safety allowed-tools: - Bash - Read diff --git a/health/SKILL.md.tmpl b/health/SKILL.md.tmpl index 512119d8a..c116ce75e 100644 --- a/health/SKILL.md.tmpl +++ b/health/SKILL.md.tmpl @@ -8,6 +8,10 @@ description: | 0-10 score, and tracks trends over time. Use when: "health check", "code quality", "how healthy is the codebase", "run all checks", "quality score". (gstack) +triggers: + - code health check + - quality dashboard + - how healthy is codebase allowed-tools: - Bash - Read diff --git a/investigate/SKILL.md.tmpl b/investigate/SKILL.md.tmpl index 07d78d1db..fc8e93126 100644 --- a/investigate/SKILL.md.tmpl +++ b/investigate/SKILL.md.tmpl @@ -19,6 +19,12 @@ allowed-tools: - Glob - AskUserQuestion - WebSearch +triggers: + - debug this + - fix this bug + - why is this broken + - root cause analysis + - investigate this error hooks: PreToolUse: - matcher: "Edit" diff --git a/land-and-deploy/SKILL.md.tmpl b/land-and-deploy/SKILL.md.tmpl index 9c01fc02b..c5a351104 100644 --- a/land-and-deploy/SKILL.md.tmpl +++ b/land-and-deploy/SKILL.md.tmpl @@ -14,6 +14,10 @@ allowed-tools: - Glob - AskUserQuestion sensitive: true +triggers: + - merge and deploy + - land the pr + - ship to production --- {{PREAMBLE}} diff --git a/learn/SKILL.md.tmpl b/learn/SKILL.md.tmpl index a79da255d..8a0a7572c 100644 --- a/learn/SKILL.md.tmpl +++ b/learn/SKILL.md.tmpl @@ -8,6 +8,10 @@ description: | "show learnings", "prune stale learnings", or "export learnings". Proactively suggest when the user asks about past patterns or wonders "didn't we fix this before?" +triggers: + - show learnings + - what have we learned + - manage project learnings allowed-tools: - Bash - Read diff --git a/office-hours/SKILL.md.tmpl b/office-hours/SKILL.md.tmpl index b59f616b4..afe063c93 100644 --- a/office-hours/SKILL.md.tmpl +++ b/office-hours/SKILL.md.tmpl @@ -23,6 +23,11 @@ allowed-tools: - Edit - AskUserQuestion - WebSearch +triggers: + - brainstorm this + - is this worth building + - help me think through + - office hours --- {{PREAMBLE}} diff --git a/open-gstack-browser/SKILL.md.tmpl b/open-gstack-browser/SKILL.md.tmpl index ed1e1bc98..ef91a5278 100644 --- a/open-gstack-browser/SKILL.md.tmpl +++ b/open-gstack-browser/SKILL.md.tmpl @@ -9,6 +9,10 @@ description: | "open chrome", "real browser", "launch chrome", "side panel", or "control my browser". voice-triggers: - "show me the browser" +triggers: + - open gstack browser + - launch chromium + - show me the browser allowed-tools: - Bash - Read diff --git a/pair-agent/SKILL.md.tmpl b/pair-agent/SKILL.md.tmpl index 26f000cf5..75ed42d59 100644 --- a/pair-agent/SKILL.md.tmpl +++ b/pair-agent/SKILL.md.tmpl @@ -13,6 +13,10 @@ voice-triggers: - "connect agent" - "share my browser" - "remote browser access" +triggers: + - pair with agent + - connect remote agent + - share my browser allowed-tools: - Bash - Read diff --git a/plan-ceo-review/SKILL.md.tmpl b/plan-ceo-review/SKILL.md.tmpl index 8a7921ef9..d128b1802 100644 --- a/plan-ceo-review/SKILL.md.tmpl +++ b/plan-ceo-review/SKILL.md.tmpl @@ -19,6 +19,11 @@ allowed-tools: - Bash - AskUserQuestion - WebSearch +triggers: + - think bigger + - expand scope + - strategy review + - rethink this plan --- {{PREAMBLE}} diff --git a/plan-design-review/SKILL.md.tmpl b/plan-design-review/SKILL.md.tmpl index 857ff08c0..b9c42d82d 100644 --- a/plan-design-review/SKILL.md.tmpl +++ b/plan-design-review/SKILL.md.tmpl @@ -17,6 +17,10 @@ allowed-tools: - Glob - Bash - AskUserQuestion +triggers: + - design plan review + - review ux plan + - check design decisions --- {{PREAMBLE}} diff --git a/plan-devex-review/SKILL.md.tmpl b/plan-devex-review/SKILL.md.tmpl index 946393525..9f1e7c2dd 100644 --- a/plan-devex-review/SKILL.md.tmpl +++ b/plan-devex-review/SKILL.md.tmpl @@ -27,6 +27,10 @@ allowed-tools: - Bash - AskUserQuestion - WebSearch +triggers: + - developer experience review + - dx plan review + - check developer onboarding --- {{PREAMBLE}} diff --git a/plan-eng-review/SKILL.md.tmpl b/plan-eng-review/SKILL.md.tmpl index 36c9d59e8..dab83e72b 100644 --- a/plan-eng-review/SKILL.md.tmpl +++ b/plan-eng-review/SKILL.md.tmpl @@ -22,10 +22,16 @@ allowed-tools: - AskUserQuestion - Bash - WebSearch +triggers: + - review architecture + - eng plan review + - check the implementation plan --- {{PREAMBLE}} +{{GBRAIN_CONTEXT_LOAD}} + # Plan Review Mode Review this plan thoroughly before making any code changes. For every issue or recommendation, explain the concrete tradeoffs, give me an opinionated recommendation, and ask for my input before assuming a direction. @@ -295,6 +301,8 @@ Substitute values from the Completion Summary: {{LEARNINGS_LOG}} +{{GBRAIN_SAVE_RESULTS}} + ## Next Steps — Review Chaining After displaying the Review Readiness Dashboard, check if additional reviews would be valuable. Read the dashboard output to see which reviews have already been run and whether they are stale. diff --git a/qa-only/SKILL.md.tmpl b/qa-only/SKILL.md.tmpl index 713e0b9c0..75c4123cc 100644 --- a/qa-only/SKILL.md.tmpl +++ b/qa-only/SKILL.md.tmpl @@ -17,6 +17,10 @@ allowed-tools: - Write - AskUserQuestion - WebSearch +triggers: + - qa report only + - just report bugs + - test but dont fix --- {{PREAMBLE}} diff --git a/qa/SKILL.md.tmpl b/qa/SKILL.md.tmpl index 9afc85485..62081d2c1 100644 --- a/qa/SKILL.md.tmpl +++ b/qa/SKILL.md.tmpl @@ -24,12 +24,18 @@ allowed-tools: - Grep - AskUserQuestion - WebSearch +triggers: + - qa test this + - find bugs on site + - test the site --- {{PREAMBLE}} {{BASE_BRANCH_DETECT}} +{{GBRAIN_CONTEXT_LOAD}} + # /qa: Test → Fix → Verify You are a QA engineer AND a bug-fix engineer. Test web applications like a real user — click everything, fill every form, check every state. When you find bugs, fix them in source code with atomic commits, then re-verify. Produce a structured report with before/after evidence. @@ -323,6 +329,8 @@ If the repo has a `TODOS.md`: {{LEARNINGS_LOG}} +{{GBRAIN_SAVE_RESULTS}} + ## Additional Rules (qa-specific) 11. **Clean working tree required.** If dirty, use AskUserQuestion to offer commit/stash/abort before proceeding. diff --git a/retro/SKILL.md.tmpl b/retro/SKILL.md.tmpl index 1d85abe12..7b3300364 100644 --- a/retro/SKILL.md.tmpl +++ b/retro/SKILL.md.tmpl @@ -14,6 +14,10 @@ allowed-tools: - Write - Glob - AskUserQuestion +triggers: + - weekly retro + - what did we ship + - engineering retrospective --- {{PREAMBLE}} diff --git a/review/SKILL.md.tmpl b/review/SKILL.md.tmpl index a38e0f7fe..7863639d6 100644 --- a/review/SKILL.md.tmpl +++ b/review/SKILL.md.tmpl @@ -17,6 +17,11 @@ allowed-tools: - Agent - AskUserQuestion - WebSearch +triggers: + - review this pr + - code review + - check my diff + - pre-landing review --- {{PREAMBLE}} diff --git a/setup-browser-cookies/SKILL.md.tmpl b/setup-browser-cookies/SKILL.md.tmpl index f3b72b714..f812d9f56 100644 --- a/setup-browser-cookies/SKILL.md.tmpl +++ b/setup-browser-cookies/SKILL.md.tmpl @@ -7,6 +7,10 @@ description: | 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". (gstack) +triggers: + - import browser cookies + - login to test site + - setup authenticated session allowed-tools: - Bash - Read diff --git a/setup-deploy/SKILL.md.tmpl b/setup-deploy/SKILL.md.tmpl index 8326da977..587a993c0 100644 --- a/setup-deploy/SKILL.md.tmpl +++ b/setup-deploy/SKILL.md.tmpl @@ -9,6 +9,10 @@ description: | the configuration to CLAUDE.md so all future deploys are automatic. Use when: "setup deploy", "configure deployment", "set up land-and-deploy", "how do I deploy with gstack", "add deploy config". +triggers: + - configure deploy + - setup deployment + - set deploy platform allowed-tools: - Bash - Read diff --git a/ship/SKILL.md.tmpl b/ship/SKILL.md.tmpl index 76e4873d6..0af2ea62a 100644 --- a/ship/SKILL.md.tmpl +++ b/ship/SKILL.md.tmpl @@ -19,12 +19,19 @@ allowed-tools: - AskUserQuestion - WebSearch sensitive: true +triggers: + - ship it + - create a pr + - push to main + - deploy this --- {{PREAMBLE}} {{BASE_BRANCH_DETECT}} +{{GBRAIN_CONTEXT_LOAD}} + # Ship: Fully Automated Ship Workflow You are running the `/ship` workflow. This is a **non-interactive, fully automated** workflow. Do NOT ask for confirmation at any step. The user said `/ship` which means DO IT. Run straight through and output the PR URL at the end. @@ -345,6 +352,8 @@ For each classified comment: {{LEARNINGS_LOG}} +{{GBRAIN_SAVE_RESULTS}} + ## Step 4: Version bump (auto-decide) **Idempotency check:** Before bumping, compare VERSION against the base branch. diff --git a/unfreeze/SKILL.md.tmpl b/unfreeze/SKILL.md.tmpl index c35d42393..83e2827c8 100644 --- a/unfreeze/SKILL.md.tmpl +++ b/unfreeze/SKILL.md.tmpl @@ -6,6 +6,10 @@ description: | 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". (gstack) +triggers: + - unfreeze edits + - unlock all directories + - remove edit restrictions allowed-tools: - Bash - Read