garrytan · cathrynlavery · May 27, 2026 · May 27, 2026 · May 28, 2026 · May 29, 2026
diff --git a/.github/workflows/skill-docs.yml b/.github/workflows/skill-docs.yml
@@ -31,3 +31,5 @@ jobs:
             echo "Generated Factory SKILL.md files are stale. Run: bun run gen:skill-docs --host factory"
             exit 1
           }
+      - name: Validate generated skill frontmatter
+        run: bun run skill:frontmatter
diff --git a/SKILL.md b/SKILL.md
@@ -2,7 +2,7 @@
 name: gstack
 preamble-tier: 1
 version: 1.1.0
-description: Fast headless browser for QA testing and site dogfooding. (gstack)
+description: "Fast headless browser for QA testing and site dogfooding. (gstack)"
 allowed-tools:
   - Bash
   - Read

diff --git a/VERSION b/VERSION
@@ -1 +1 @@
-1.54.0.0
+1.54.1.0
diff --git a/autoplan/SKILL.md b/autoplan/SKILL.md
@@ -2,7 +2,7 @@
 name: autoplan
 preamble-tier: 3
 version: 1.0.0
-description: Auto-review pipeline — reads the full CEO, design, eng, and DX review skills from disk and runs them sequentially with auto-decisions using 6 decision principles. (gstack)
+description: "Auto-review pipeline — reads the full CEO, design, eng, and DX review skills from disk and runs them sequentially with auto-decisions using 6 decision principles. (gstack)"
 benefits-from: [office-hours]
 triggers:
   - run all reviews

diff --git a/benchmark-models/SKILL.md b/benchmark-models/SKILL.md
@@ -2,7 +2,7 @@
 name: benchmark-models
 preamble-tier: 1
 version: 1.0.0
-description: Cross-model benchmark for gstack skills. (gstack)
+description: "Cross-model benchmark for gstack skills. (gstack)"
 triggers:
   - cross model benchmark
   - compare claude gpt gemini

diff --git a/benchmark/SKILL.md b/benchmark/SKILL.md
@@ -2,7 +2,7 @@
 name: benchmark
 preamble-tier: 1
 version: 1.0.0
-description: Performance regression detection using the browse daemon. (gstack)
+description: "Performance regression detection using the browse daemon. (gstack)"
 triggers:
   - performance benchmark
   - check page speed

diff --git a/browse/SKILL.md b/browse/SKILL.md
@@ -2,7 +2,7 @@
 name: browse
 preamble-tier: 1
 version: 1.1.0
-description: Fast headless browser for QA testing and site dogfooding. (gstack)
+description: "Fast headless browser for QA testing and site dogfooding. (gstack)"
 triggers:
   - browse a page
   - headless browser

diff --git a/canary/SKILL.md b/canary/SKILL.md
@@ -2,7 +2,7 @@
 name: canary
 preamble-tier: 2
 version: 1.0.0
-description: Post-deploy canary monitoring. (gstack)
+description: "Post-deploy canary monitoring. (gstack)"
 allowed-tools:
   - Bash
   - Read

diff --git a/careful/SKILL.md b/careful/SKILL.md
@@ -1,7 +1,7 @@
 ---
 name: careful
 version: 0.1.0
-description: Safety guardrails for destructive commands. (gstack)
+description: "Safety guardrails for destructive commands. (gstack)"
 triggers:
   - be careful
   - warn before destructive

diff --git a/codex/SKILL.md b/codex/SKILL.md
@@ -2,7 +2,7 @@
 name: codex
 preamble-tier: 3
 version: 1.0.0
-description: OpenAI Codex CLI wrapper — three modes. (gstack)
+description: "OpenAI Codex CLI wrapper — three modes. (gstack)"
 triggers:
   - codex review
   - second opinion

diff --git a/context-restore/SKILL.md b/context-restore/SKILL.md
@@ -2,7 +2,7 @@
 name: context-restore
 preamble-tier: 2
 version: 1.0.0
-description: Restore working context saved earlier by /context-save. (gstack)
+description: "Restore working context saved earlier by /context-save. (gstack)"
 allowed-tools:
   - Bash
   - Read

diff --git a/context-save/SKILL.md b/context-save/SKILL.md
@@ -2,7 +2,7 @@
 name: context-save
 preamble-tier: 2
 version: 1.0.0
-description: Save working context. (gstack)
+description: "Save working context. (gstack)"
 allowed-tools:
   - Bash
   - Read

diff --git a/cso/SKILL.md b/cso/SKILL.md
@@ -2,7 +2,7 @@
 name: cso
 preamble-tier: 2
 version: 2.0.0
-description: Chief Security Officer mode. (gstack)
+description: "Chief Security Officer mode. (gstack)"
 allowed-tools:
   - Bash
   - Read

diff --git a/design-consultation/SKILL.md b/design-consultation/SKILL.md
@@ -2,7 +2,7 @@
 name: design-consultation
 preamble-tier: 3
 version: 1.0.0
-description: Design consultation: understands your product, researches the landscape, proposes a complete design system (aesthetic, typography, color, layout, spacing, motion), and generates font+color preview... (gstack)
+description: "Design consultation: understands your product, researches the landscape, proposes a complete design system (aesthetic, typography, color, layout, spacing, motion), and generates font+color preview... (gstack)"
 allowed-tools:
   - Bash
   - Read

diff --git a/design-html/SKILL.md b/design-html/SKILL.md
@@ -2,7 +2,7 @@
 name: design-html
 preamble-tier: 2
 version: 1.0.0
-description: Design finalization: generates production-quality Pretext-native HTML/CSS. (gstack)
+description: "Design finalization: generates production-quality Pretext-native HTML/CSS. (gstack)"
 triggers:
   - build the design
   - code the mockup

diff --git a/design-review/SKILL.md b/design-review/SKILL.md
@@ -2,7 +2,7 @@
 name: design-review
 preamble-tier: 4
 version: 2.0.0
-description: Designer's eye QA: finds visual inconsistency, spacing issues, hierarchy problems, AI slop patterns, and slow interactions — then fixes them. (gstack)
+description: "Designer's eye QA: finds visual inconsistency, spacing issues, hierarchy problems, AI slop patterns, and slow interactions — then fixes them. (gstack)"
 allowed-tools:
   - Bash
   - Read

diff --git a/design-shotgun/SKILL.md b/design-shotgun/SKILL.md
@@ -2,7 +2,7 @@
 name: design-shotgun
 preamble-tier: 2
 version: 1.0.0
-description: Design shotgun: generate multiple AI design variants, open a comparison board, collect structured feedback, and iterate. (gstack)
+description: "Design shotgun: generate multiple AI design variants, open a comparison board, collect structured feedback, and iterate. (gstack)"
 triggers:
   - explore design variants
   - show me design options

diff --git a/devex-review/SKILL.md b/devex-review/SKILL.md
@@ -2,7 +2,7 @@
 name: devex-review
 preamble-tier: 3
 version: 1.0.0
-description: Live developer experience audit. (gstack)
+description: "Live developer experience audit. (gstack)"
 triggers:
   - live dx audit
   - test developer experience

diff --git a/document-generate/SKILL.md b/document-generate/SKILL.md
@@ -2,7 +2,7 @@
 name: document-generate
 preamble-tier: 2
 version: 1.0.0
-description: Generate missing documentation from scratch for a feature, module, or entire project. (gstack)
+description: "Generate missing documentation from scratch for a feature, module, or entire project. (gstack)"
 allowed-tools:
   - Bash
   - Read

diff --git a/document-release/SKILL.md b/document-release/SKILL.md
@@ -2,7 +2,7 @@
 name: document-release
 preamble-tier: 2
 version: 1.0.0
-description: Post-ship documentation update. (gstack)
+description: "Post-ship documentation update. (gstack)"
 allowed-tools:
   - Bash
   - Read

diff --git a/freeze/SKILL.md b/freeze/SKILL.md
@@ -1,7 +1,7 @@
 ---
 name: freeze
 version: 0.1.0
-description: Restrict file edits to a specific directory for the session. (gstack)
+description: "Restrict file edits to a specific directory for the session. (gstack)"
 triggers:
   - freeze edits to directory
   - lock editing scope

diff --git a/gstack-upgrade/SKILL.md b/gstack-upgrade/SKILL.md
@@ -1,7 +1,7 @@
 ---
 name: gstack-upgrade
 version: 1.1.0
-description: Upgrade gstack to the latest version.
+description: "Upgrade gstack to the latest version."
 triggers:
   - upgrade gstack
   - update gstack version

diff --git a/guard/SKILL.md b/guard/SKILL.md
@@ -1,7 +1,7 @@
 ---
 name: guard
 version: 0.1.0
-description: Full safety mode: destructive command warnings + directory-scoped edits. (gstack)
+description: "Full safety mode: destructive command warnings + directory-scoped edits. (gstack)"
 triggers:
   - full safety mode
   - guard against mistakes

diff --git a/health/SKILL.md b/health/SKILL.md
@@ -2,7 +2,7 @@
 name: health
 preamble-tier: 2
 version: 1.0.0
-description: Code quality dashboard. (gstack)
+description: "Code quality dashboard. (gstack)"
 triggers:
   - code health check
   - quality dashboard

diff --git a/investigate/SKILL.md b/investigate/SKILL.md
@@ -2,7 +2,7 @@
 name: investigate
 preamble-tier: 2
 version: 1.0.0
-description: Systematic debugging with root cause investigation. (gstack)
+description: "Systematic debugging with root cause investigation. (gstack)"
 allowed-tools:
   - Bash
   - Read

diff --git a/ios-clean/SKILL.md b/ios-clean/SKILL.md
@@ -2,7 +2,7 @@
 name: ios-clean
 preamble-tier: 3
 version: 1.0.0
-description: Remove the DebugBridge SPM package and all #if DEBUG wiring from an iOS app. (gstack)
+description: "Remove the DebugBridge SPM package and all #if DEBUG wiring from an iOS app. (gstack)"
 allowed-tools:
   - Bash
   - Read

diff --git a/ios-design-review/SKILL.md b/ios-design-review/SKILL.md
@@ -2,7 +2,7 @@
 name: ios-design-review
 preamble-tier: 3
 version: 1.0.0
-description: Visual design audit for iOS apps on real hardware. (gstack)
+description: "Visual design audit for iOS apps on real hardware. (gstack)"
 allowed-tools:
   - Bash
   - Read

diff --git a/ios-fix/SKILL.md b/ios-fix/SKILL.md
@@ -2,7 +2,7 @@
 name: ios-fix
 preamble-tier: 3
 version: 1.0.0
-description: Autonomous iOS bug fixer. (gstack)
+description: "Autonomous iOS bug fixer. (gstack)"
 allowed-tools:
   - Bash
   - Read

diff --git a/ios-qa/SKILL.md b/ios-qa/SKILL.md
@@ -2,7 +2,7 @@
 name: ios-qa
 preamble-tier: 3
 version: 1.0.0
-description: Live-device iOS QA for SwiftUI apps. (gstack)
+description: "Live-device iOS QA for SwiftUI apps. (gstack)"
 allowed-tools:
   - Bash
   - Read

diff --git a/ios-sync/SKILL.md b/ios-sync/SKILL.md
@@ -2,7 +2,7 @@
 name: ios-sync
 preamble-tier: 3
 version: 1.0.0
-description: Regenerate the iOS debug bridge against the latest upstream gstack templates. (gstack)
+description: "Regenerate the iOS debug bridge against the latest upstream gstack templates. (gstack)"
 allowed-tools:
   - Bash
   - Read

diff --git a/land-and-deploy/SKILL.md b/land-and-deploy/SKILL.md
@@ -2,7 +2,7 @@
 name: land-and-deploy
 preamble-tier: 4
 version: 1.0.0
-description: Land and deploy workflow. (gstack)
+description: "Land and deploy workflow. (gstack)"
 allowed-tools:
   - Bash
   - Read

diff --git a/landing-report/SKILL.md b/landing-report/SKILL.md
@@ -1,7 +1,7 @@
 ---
 name: landing-report
 version: 0.1.0
-description: Read-only queue dashboard for workspace-aware ship. (gstack)
+description: "Read-only queue dashboard for workspace-aware ship. (gstack)"
 triggers:
   - landing report
   - version queue

diff --git a/learn/SKILL.md b/learn/SKILL.md
@@ -2,7 +2,7 @@
 name: learn
 preamble-tier: 2
 version: 1.0.0
-description: Manage project learnings.
+description: "Manage project learnings."
 triggers:
   - show learnings
   - what have we learned

diff --git a/make-pdf/SKILL.md b/make-pdf/SKILL.md
@@ -2,7 +2,7 @@
 name: make-pdf
 preamble-tier: 1
 version: 1.0.0
-description: Turn any markdown file into a publication-quality PDF. (gstack)
+description: "Turn any markdown file into a publication-quality PDF. (gstack)"
 triggers:
   - markdown to pdf
   - generate pdf

diff --git a/office-hours/SKILL.md b/office-hours/SKILL.md
@@ -2,7 +2,7 @@
 name: office-hours
 preamble-tier: 3
 version: 2.0.0
-description: YC Office Hours — two modes. (gstack)
+description: "YC Office Hours — two modes. (gstack)"
 allowed-tools:
   - Bash
   - Read

diff --git a/open-gstack-browser/SKILL.md b/open-gstack-browser/SKILL.md
@@ -1,7 +1,7 @@
 ---
 name: open-gstack-browser
 version: 0.2.0
-description: Launch GStack Browser — AI-controlled Chromium with the sidebar extension baked in.
+description: "Launch GStack Browser — AI-controlled Chromium with the sidebar extension baked in."
 triggers:
   - open gstack browser
   - launch chromium

diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "gstack",
-  "version": "1.54.0.0",
+  "version": "1.54.1.0",
   "description": "Garry's Stack — Claude Code skills + fast headless browser. One repo, one install, entire AI engineering workflow.",
   "license": "MIT",
   "type": "module",
@@ -31,6 +31,7 @@
     "test:gemini": "EVALS=1 bun test test/gemini-e2e.test.ts",
     "test:gemini:all": "EVALS=1 EVALS_ALL=1 bun test test/gemini-e2e.test.ts",
     "skill:check": "bun run scripts/skill-check.ts",
+    "skill:frontmatter": "bun run scripts/skill-frontmatter-check.ts",
     "dev:skill": "bun run scripts/dev-skill.ts",
     "start": "bun run browse/src/server.ts",
     "eval:list": "bun run scripts/eval-list.ts",

diff --git a/pair-agent/SKILL.md b/pair-agent/SKILL.md
@@ -1,7 +1,7 @@
 ---
 name: pair-agent
 version: 0.1.0
-description: Pair a remote AI agent with your browser. (gstack)
+description: "Pair a remote AI agent with your browser. (gstack)"
 triggers:
   - pair with agent
   - connect remote agent

diff --git a/plan-ceo-review/SKILL.md b/plan-ceo-review/SKILL.md
@@ -3,7 +3,7 @@ name: plan-ceo-review
 preamble-tier: 3
 interactive: true
 version: 1.0.0
-description: CEO/founder-mode plan review. (gstack)
+description: "CEO/founder-mode plan review. (gstack)"
 benefits-from: [office-hours]
 allowed-tools:
   - Read

diff --git a/plan-design-review/SKILL.md b/plan-design-review/SKILL.md
@@ -3,7 +3,7 @@ name: plan-design-review
 preamble-tier: 3
 interactive: true
 version: 2.0.0
-description: Designer's eye plan review — interactive, like CEO and Eng review. (gstack)
+description: "Designer's eye plan review — interactive, like CEO and Eng review. (gstack)"
 allowed-tools:
   - Read
   - Edit

diff --git a/plan-devex-review/SKILL.md b/plan-devex-review/SKILL.md
@@ -3,7 +3,7 @@ name: plan-devex-review
 preamble-tier: 3
 interactive: true
 version: 2.0.0
-description: Interactive developer experience plan review. (gstack)
+description: "Interactive developer experience plan review. (gstack)"
 benefits-from: [office-hours]
 allowed-tools:
   - Read

diff --git a/plan-eng-review/SKILL.md b/plan-eng-review/SKILL.md
@@ -3,7 +3,7 @@ name: plan-eng-review
 preamble-tier: 3
 interactive: true
 version: 1.0.0
-description: Eng manager-mode plan review. (gstack)
+description: "Eng manager-mode plan review. (gstack)"
 benefits-from: [office-hours]
 allowed-tools:
   - Read

diff --git a/plan-tune/SKILL.md b/plan-tune/SKILL.md
@@ -2,7 +2,7 @@
 name: plan-tune
 preamble-tier: 2
 version: 1.0.0
-description: Self-tuning question sensitivity + developer psychographic for gstack (v1: observational). (gstack)
+description: "Self-tuning question sensitivity + developer psychographic for gstack (v1: observational). (gstack)"
 triggers:
   - tune questions
   - stop asking me that

diff --git a/qa-only/SKILL.md b/qa-only/SKILL.md
@@ -2,7 +2,7 @@
 name: qa-only
 preamble-tier: 4
 version: 1.0.0
-description: Report-only QA testing. (gstack)
+description: "Report-only QA testing. (gstack)"
 allowed-tools:
   - Bash
   - Read