From c213be39434fe5a6f9e5b2dedc2fe17a8c31ea1d Mon Sep 17 00:00:00 2001 From: Garry Tan Date: Sun, 22 Mar 2026 22:54:36 -0700 Subject: [PATCH] fix: shorten auto-trigger guard to stay under 1024-char description limit Co-Authored-By: Claude Opus 4.6 (1M context) --- SKILL.md | 3 +-- autoplan/SKILL.md | 3 +-- benchmark/SKILL.md | 3 +-- browse/SKILL.md | 3 +-- canary/SKILL.md | 3 +-- careful/SKILL.md | 3 +-- codex/SKILL.md | 3 +-- cso/SKILL.md | 3 +-- design-consultation/SKILL.md | 3 +-- design-review/SKILL.md | 3 +-- document-release/SKILL.md | 3 +-- freeze/SKILL.md | 3 +-- gstack-upgrade/SKILL.md | 3 +-- guard/SKILL.md | 3 +-- investigate/SKILL.md | 3 +-- land-and-deploy/SKILL.md | 3 +-- office-hours/SKILL.md | 3 +-- plan-ceo-review/SKILL.md | 3 +-- plan-design-review/SKILL.md | 3 +-- plan-eng-review/SKILL.md | 3 +-- qa-only/SKILL.md | 3 +-- qa/SKILL.md | 3 +-- retro/SKILL.md | 3 +-- review/SKILL.md | 3 +-- scripts/gen-skill-docs.ts | 2 +- setup-browser-cookies/SKILL.md | 3 +-- setup-deploy/SKILL.md | 3 +-- ship/SKILL.md | 3 +-- unfreeze/SKILL.md | 3 +-- 29 files changed, 29 insertions(+), 57 deletions(-) diff --git a/SKILL.md b/SKILL.md index ad1abb98..7c3113a7 100644 --- a/SKILL.md +++ b/SKILL.md @@ -2,8 +2,7 @@ name: gstack version: 1.1.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /gstack in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /gstack. 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 diff --git a/autoplan/SKILL.md b/autoplan/SKILL.md index c03bd26d..88a48145 100644 --- a/autoplan/SKILL.md +++ b/autoplan/SKILL.md @@ -2,8 +2,7 @@ name: autoplan version: 1.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /autoplan in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /autoplan. Auto-review pipeline — reads the full CEO, design, and eng review skills from disk and runs them sequentially with auto-decisions using 6 decision principles. Surfaces taste decisions (close approaches, borderline scope, codex disagreements) at a final diff --git a/benchmark/SKILL.md b/benchmark/SKILL.md index a7f0c7f6..98ed58b4 100644 --- a/benchmark/SKILL.md +++ b/benchmark/SKILL.md @@ -2,8 +2,7 @@ name: benchmark version: 1.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /benchmark in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /benchmark. Performance regression detection using the browse daemon. Establishes baselines for page load times, Core Web Vitals, and resource sizes. Compares before/after on every PR. Tracks performance trends over time. diff --git a/browse/SKILL.md b/browse/SKILL.md index ca7db3e9..d5c440fe 100644 --- a/browse/SKILL.md +++ b/browse/SKILL.md @@ -2,8 +2,7 @@ name: browse version: 1.1.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /browse in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /browse. Fast headless browser for QA testing and site dogfooding. Navigate any URL, interact with elements, verify page state, diff before/after actions, take annotated screenshots, check responsive layouts, test forms and uploads, handle dialogs, and assert element states. diff --git a/canary/SKILL.md b/canary/SKILL.md index 9fa166de..7a92ba87 100644 --- a/canary/SKILL.md +++ b/canary/SKILL.md @@ -2,8 +2,7 @@ name: canary version: 1.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /canary in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /canary. Post-deploy canary monitoring. Watches the live app for console errors, performance regressions, and page failures using the browse daemon. Takes periodic screenshots, compares against pre-deploy baselines, and alerts diff --git a/careful/SKILL.md b/careful/SKILL.md index b5442fdc..94343653 100644 --- a/careful/SKILL.md +++ b/careful/SKILL.md @@ -2,8 +2,7 @@ name: careful version: 0.1.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /careful in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /careful. Safety guardrails for destructive commands. Warns before rm -rf, DROP TABLE, force-push, git reset --hard, kubectl delete, and similar destructive operations. User can override each warning. Use when touching prod, debugging live systems, diff --git a/codex/SKILL.md b/codex/SKILL.md index e8a011f7..68eccfe3 100644 --- a/codex/SKILL.md +++ b/codex/SKILL.md @@ -2,8 +2,7 @@ name: codex version: 1.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /codex in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /codex. OpenAI Codex CLI wrapper — three modes. Code review: independent diff review via 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. diff --git a/cso/SKILL.md b/cso/SKILL.md index 195c6b15..3edc16e8 100644 --- a/cso/SKILL.md +++ b/cso/SKILL.md @@ -2,8 +2,7 @@ name: cso version: 1.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /cso in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /cso. Chief Security Officer mode. Performs OWASP Top 10 audit, STRIDE threat modeling, attack surface analysis, auth flow verification, secret detection, dependency CVE scanning, supply chain risk assessment, and data classification review. diff --git a/design-consultation/SKILL.md b/design-consultation/SKILL.md index f8057028..0586ead1 100644 --- a/design-consultation/SKILL.md +++ b/design-consultation/SKILL.md @@ -2,8 +2,7 @@ name: design-consultation version: 1.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /design-consultation in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /design-consultation. Design consultation: understands your product, researches the landscape, proposes a complete design system (aesthetic, typography, color, layout, spacing, motion), and generates font+color preview pages. Creates DESIGN.md as your project's design source diff --git a/design-review/SKILL.md b/design-review/SKILL.md index fa8a3a46..aa7d8bec 100644 --- a/design-review/SKILL.md +++ b/design-review/SKILL.md @@ -2,8 +2,7 @@ name: design-review version: 2.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /design-review in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /design-review. Designer's eye QA: finds visual inconsistency, spacing issues, hierarchy problems, AI slop patterns, and slow interactions — then fixes them. Iteratively fixes issues in source code, committing each fix atomically and re-verifying with before/after diff --git a/document-release/SKILL.md b/document-release/SKILL.md index 4cdfe977..fc667ce5 100644 --- a/document-release/SKILL.md +++ b/document-release/SKILL.md @@ -2,8 +2,7 @@ name: document-release version: 1.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /document-release in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /document-release. Post-ship documentation update. Reads all project docs, cross-references the diff, updates README/ARCHITECTURE/CONTRIBUTING/CLAUDE.md to match what shipped, polishes CHANGELOG voice, cleans up TODOS, and optionally bumps VERSION. Use when diff --git a/freeze/SKILL.md b/freeze/SKILL.md index 1a49816b..6fa53992 100644 --- a/freeze/SKILL.md +++ b/freeze/SKILL.md @@ -2,8 +2,7 @@ name: freeze version: 0.1.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /freeze in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /freeze. Restrict file edits to a specific directory for the session. Blocks Edit and Write outside the allowed path. Use when debugging to prevent accidentally "fixing" unrelated code, or when you want to scope changes to one module. diff --git a/gstack-upgrade/SKILL.md b/gstack-upgrade/SKILL.md index 4bf1b6db..7f70a28b 100644 --- a/gstack-upgrade/SKILL.md +++ b/gstack-upgrade/SKILL.md @@ -2,8 +2,7 @@ name: gstack-upgrade version: 1.1.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /gstack-upgrade in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /gstack-upgrade. Upgrade gstack to the latest version. Detects global vs vendored install, runs the upgrade, and shows what's new. Use when asked to "upgrade gstack", "update gstack", or "get latest version". diff --git a/guard/SKILL.md b/guard/SKILL.md index ce038a87..4758ded5 100644 --- a/guard/SKILL.md +++ b/guard/SKILL.md @@ -2,8 +2,7 @@ name: guard version: 0.1.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /guard in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /guard. Full safety mode: destructive command warnings + directory-scoped edits. Combines /careful (warns before rm -rf, DROP TABLE, force-push, etc.) with /freeze (blocks edits outside a specified directory). Use for maximum safety diff --git a/investigate/SKILL.md b/investigate/SKILL.md index c54e7be4..c93cc26e 100644 --- a/investigate/SKILL.md +++ b/investigate/SKILL.md @@ -2,8 +2,7 @@ name: investigate version: 1.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /investigate in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /investigate. Systematic debugging with root cause investigation. Four phases: investigate, analyze, hypothesize, implement. Iron Law: no fixes without root cause. Use when asked to "debug this", "fix this bug", "why is this broken", diff --git a/land-and-deploy/SKILL.md b/land-and-deploy/SKILL.md index 456bd784..7cda5655 100644 --- a/land-and-deploy/SKILL.md +++ b/land-and-deploy/SKILL.md @@ -2,8 +2,7 @@ name: land-and-deploy version: 1.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /land-and-deploy in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /land-and-deploy. 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", diff --git a/office-hours/SKILL.md b/office-hours/SKILL.md index acb5b5ef..212b0215 100644 --- a/office-hours/SKILL.md +++ b/office-hours/SKILL.md @@ -2,8 +2,7 @@ name: office-hours version: 2.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /office-hours in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /office-hours. YC Office Hours — two modes. Startup mode: six forcing questions that expose demand reality, status quo, desperate specificity, narrowest wedge, observation, and future-fit. Builder mode: design thinking brainstorming for side projects, diff --git a/plan-ceo-review/SKILL.md b/plan-ceo-review/SKILL.md index c359cfef..376451a6 100644 --- a/plan-ceo-review/SKILL.md +++ b/plan-ceo-review/SKILL.md @@ -2,8 +2,7 @@ name: plan-ceo-review version: 1.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /plan-ceo-review in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /plan-ceo-review. CEO/founder-mode plan review. Rethink the problem, find the 10-star product, challenge premises, expand scope when it creates a better product. Four modes: SCOPE EXPANSION (dream big), SELECTIVE EXPANSION (hold scope + cherry-pick diff --git a/plan-design-review/SKILL.md b/plan-design-review/SKILL.md index 14ebac63..d0161cd3 100644 --- a/plan-design-review/SKILL.md +++ b/plan-design-review/SKILL.md @@ -2,8 +2,7 @@ name: plan-design-review version: 2.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /plan-design-review in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /plan-design-review. Designer's eye plan review — interactive, like CEO and Eng review. Rates each design dimension 0-10, explains what would make it a 10, then fixes the plan to get there. Works in plan mode. For live site diff --git a/plan-eng-review/SKILL.md b/plan-eng-review/SKILL.md index d42a2cbd..c2c6b9ac 100644 --- a/plan-eng-review/SKILL.md +++ b/plan-eng-review/SKILL.md @@ -2,8 +2,7 @@ name: plan-eng-review version: 1.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /plan-eng-review in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /plan-eng-review. Eng manager-mode plan review. Lock in the execution plan — architecture, data flow, diagrams, edge cases, test coverage, performance. Walks through issues interactively with opinionated recommendations. Use when asked to diff --git a/qa-only/SKILL.md b/qa-only/SKILL.md index 9276e25c..b6461b70 100644 --- a/qa-only/SKILL.md +++ b/qa-only/SKILL.md @@ -2,8 +2,7 @@ name: qa-only version: 1.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /qa-only in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /qa-only. Report-only QA testing. Systematically tests a web application and produces a structured report with health score, screenshots, and repro steps — but never fixes anything. Use when asked to "just report bugs", "qa report only", or diff --git a/qa/SKILL.md b/qa/SKILL.md index c1eef63f..f363300c 100644 --- a/qa/SKILL.md +++ b/qa/SKILL.md @@ -2,8 +2,7 @@ name: qa version: 2.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /qa in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /qa. Systematically QA test a web application and fix bugs found. Runs QA testing, then iteratively fixes bugs in source code, committing each fix atomically and re-verifying. Use when asked to "qa", "QA", "test this site", "find bugs", diff --git a/retro/SKILL.md b/retro/SKILL.md index 47e110e8..d5b87b56 100644 --- a/retro/SKILL.md +++ b/retro/SKILL.md @@ -2,8 +2,7 @@ name: retro version: 2.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /retro in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /retro. Weekly engineering retrospective. Analyzes commit history, work patterns, and code quality metrics with persistent history and trend tracking. Team-aware: breaks down per-person contributions with praise and growth areas. diff --git a/review/SKILL.md b/review/SKILL.md index 566f6278..c8a5ab0c 100644 --- a/review/SKILL.md +++ b/review/SKILL.md @@ -2,8 +2,7 @@ name: review version: 1.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /review in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /review. 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". diff --git a/scripts/gen-skill-docs.ts b/scripts/gen-skill-docs.ts index a9640cdb..97ddcb51 100644 --- a/scripts/gen-skill-docs.ts +++ b/scripts/gen-skill-docs.ts @@ -2972,7 +2972,7 @@ function processTemplate(tmplPath: string, host: Host = 'claude'): { outputPath: // Adds explicit trigger criteria so Claude Code doesn't auto-fire skills // based on semantic similarity. Preserves existing "Use when" and // "Proactively suggest" text (both are tested in skill-validation.test.ts). - const triggerGuard = ` MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /${skillName} in their message.\n Do not auto-trigger this skill from semantic similarity alone.\n`; + const triggerGuard = ` MANUAL TRIGGER ONLY: invoke only when user types /${skillName}.\n`; const descMatch = content.match(/^(description:\s*\|?\s*\n)/m); if (descMatch && descMatch.index !== undefined) { const insertAt = descMatch.index + descMatch[0].length; diff --git a/setup-browser-cookies/SKILL.md b/setup-browser-cookies/SKILL.md index df03f9d8..0748472e 100644 --- a/setup-browser-cookies/SKILL.md +++ b/setup-browser-cookies/SKILL.md @@ -2,8 +2,7 @@ name: setup-browser-cookies version: 1.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /setup-browser-cookies in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /setup-browser-cookies. 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", diff --git a/setup-deploy/SKILL.md b/setup-deploy/SKILL.md index c55f0e2b..fa07e917 100644 --- a/setup-deploy/SKILL.md +++ b/setup-deploy/SKILL.md @@ -2,8 +2,7 @@ name: setup-deploy version: 1.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /setup-deploy in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /setup-deploy. Configure deployment settings for /land-and-deploy. Detects your deploy platform (Fly.io, Render, Vercel, Netlify, Heroku, GitHub Actions, custom), production URL, health check endpoints, and deploy status commands. Writes diff --git a/ship/SKILL.md b/ship/SKILL.md index 85a4f4b6..89e037d5 100644 --- a/ship/SKILL.md +++ b/ship/SKILL.md @@ -2,8 +2,7 @@ name: ship version: 1.0.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /ship in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /ship. 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. allowed-tools: diff --git a/unfreeze/SKILL.md b/unfreeze/SKILL.md index 2d032a5e..16eda041 100644 --- a/unfreeze/SKILL.md +++ b/unfreeze/SKILL.md @@ -2,8 +2,7 @@ name: unfreeze version: 0.1.0 description: | - MANUAL TRIGGER ONLY: only run this skill when the user explicitly types /unfreeze in their message. - Do not auto-trigger this skill from semantic similarity alone. + MANUAL TRIGGER ONLY: invoke only when user types /unfreeze. 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