@haus-tech/haus-workflow 0.17.1 → 0.18.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.18.1](https://github.com/WeAreHausTech/haus-workflow/compare/v0.18.0...v0.18.1) (2026-06-09)
+
+### Bug Fixes
+
+- **ci:** improve PR creation logic in sync-catalog-fixture workflow ([d7717d6](https://github.com/WeAreHausTech/haus-workflow/commit/d7717d6024bb400b02f3254ff7f2d33b6e1fb4c6))
+
+## [0.18.0](https://github.com/WeAreHausTech/haus-workflow/compare/v0.17.1...v0.18.0) (2026-06-09)
+
+### Features
+
+- prune stale catalog copies and simplify validators ([#83](https://github.com/WeAreHausTech/haus-workflow/issues/83)) ([f87541c](https://github.com/WeAreHausTech/haus-workflow/commit/f87541cc182e9cf2461ba6b388dc227aba88900e))
+
+### Bug Fixes
+
+- **validate:** parse folded YAML description frontmatter ([#84](https://github.com/WeAreHausTech/haus-workflow/issues/84)) ([677d7de](https://github.com/WeAreHausTech/haus-workflow/commit/677d7def4e838c4e5381f34c870a5525c4614073))
+
 ## [0.17.1](https://github.com/WeAreHausTech/haus-workflow/compare/v0.17.0...v0.17.1) (2026-06-09)
 
 ### Bug Fixes

package/README.md

@@ -66,12 +66,13 @@ haus setup-project     # re-run setup on existing project
 haus scan              # scan repo and write context-map
 haus recommend         # recommend catalog items (binary eligibility)
 haus apply --dry-run   # preview what would be written
-haus apply --write     # write .claude/ files
+haus apply --write     # write .claude/ files (skills, agents, commands, templates)
+haus apply --select    # interactively choose which recommended items to install
 haus apply --refill-config    # fill still-blank workflow-config.md fields, keep edits
 haus context --task "<task>"  # select context rules for a task (token-budgeted)
-haus update                   # sync remote catalog + refresh lockfile
+haus update                   # sync remote catalog + re-apply project files
 haus update --check           # check for updates without applying
-haus undo                     # undo last applied changes
+haus undo                     # remove haus-managed project files (lock-tracked paths)
 haus doctor                   # health check: hooks, CLAUDE.md, imports, catalog cache
 haus config                   # manage hook configuration
 haus guard                    # test bash/file-access guards
@@ -91,9 +92,19 @@ yarn verify   # typecheck + lint + build + test
 yarn dev <cmd>  # run CLI without building (tsx)
 ```
 
+### Catalog
+
+Content lives in [`haus-workflow-catalog`](https://github.com/WeAreHausTech/haus-workflow-catalog)
+(71 items at v2.5.0). Fetched at runtime from `main` (override with `HAUS_CATALOG_REF`).
+Validation rules sync from catalog → `library/catalog/validation-rules.json` (ADR-0001).
+
+On `haus apply` / `haus update`, items **removed from the catalog** are pruned from the
+project when their on-disk copy still matches the lock hash; user-edited copies are kept.
+
 ### Internal docs
 
 - [Architecture](docs/architecture.md)
 - [CLI reference](docs/cli.md)
 - [Security](docs/security.md)
 - [Developer scripts](docs/dev.md)
+- [Runbook](docs/runbook.md)

package/dist/cli.js

@@ -1262,6 +1262,7 @@ async function writeClaudeFiles(root, dryRun, selectedIds, opts = {}) {
       );
     }
   }
+  await cleanupStaleCatalogItems(root, new Set(manifestById.keys()), dryRun);
   if (dryRun) return [...new Set(files)];
   const installedItems = catalogItems.filter((r) => installedIds.has(r.id));
   await writeManagedJson(
@@ -1304,6 +1305,50 @@ async function writeClaudeFiles(root, dryRun, selectedIds, opts = {}) {
   await writeManagedJson(root, hausPath(root, "haus.lock.json"), lock, false);
   return [...new Set(files)];
 }
+async function cleanupStaleCatalogItems(root, knownIds, dryRun) {
+  const prevLock = await readJson(hausPath(root, "haus.lock.json"));
+  if (!prevLock?.length) return;
+  for (const entry of prevLock) {
+    if (!entry.id || knownIds.has(entry.id)) continue;
+    const relPaths = entry.paths ?? [];
+    if (relPaths.length === 0) continue;
+    const existing = [];
+    for (const rel of relPaths) {
+      if (await fs10.pathExists(path12.join(root, rel))) existing.push(rel);
+    }
+    if (existing.length === 0) continue;
+    if (entry.hash === void 0) {
+      warn(
+        `Stale catalog item ${entry.id} has no lock hash \u2014 leaving in place: ${existing.join(", ")}`
+      );
+      continue;
+    }
+    const currentHash = await hashInstalledPaths(root, relPaths);
+    if (currentHash !== entry.hash) {
+      warn(
+        `Stale catalog item ${entry.id} was modified locally \u2014 leaving in place: ${existing.join(", ")}`
+      );
+      continue;
+    }
+    for (const rel of existing) {
+      const abs = path12.join(root, rel);
+      if (dryRun) {
+        log(`[dry-run] would remove stale ${displayPath(root, abs)} (${entry.id})`);
+        continue;
+      }
+      await fs10.remove(abs);
+      await pruneEmptyDir(path12.dirname(abs));
+      log(`Removed stale ${displayPath(root, abs)} (${entry.id})`);
+    }
+  }
+}
+async function pruneEmptyDir(dir) {
+  try {
+    const entries = await fs10.readdir(dir);
+    if (entries.length === 0) await fs10.remove(dir);
+  } catch {
+  }
+}
 async function writeManagedText(root, filePath, nextText, dryRun) {
   const prev = await fs10.pathExists(filePath) ? await fs10.readFile(filePath, "utf8") : "";
   const printable = displayPath(root, filePath);
@@ -1424,7 +1469,7 @@ var validation_rules_default = {
     "trading"
   ],
   bannedAgentPhrases: ["autonomous", "swarm", "delegate", "orchestrat", "marketplace"],
-  requiredSkillSections: ["## Use when", "## Do not use when"],
+  requiredSkillFrontmatter: ["description"],
   requiredAgentSections: ["## Use when", "## Do not use when", "## Verification"],
   riskyInstallPatterns: [
     { source: "\\bnpx\\s+-y\\b", flags: "i" },
@@ -1549,19 +1594,14 @@ var validation_rules_default = {
     "baseline",
     "project-instructions"
   ],
-  patternTagSuffixes: ["-patterns"],
-  skillSectionExemptSources: ["curated"]
+  patternTagSuffixes: ["-patterns"]
 };
 
 // src/catalog/validation-rules.ts
 var toRegExp = (r) => new RegExp(r.source, r.flags);
 var FORBIDDEN_TAGS = validation_rules_default.forbiddenTags;
 var BANNED_AGENT_PHRASES = validation_rules_default.bannedAgentPhrases;
-var REQUIRED_SKILL_SECTIONS = validation_rules_default.requiredSkillSections;
-var SKILL_SECTION_EXEMPT_SOURCES = validation_rules_default.skillSectionExemptSources;
-function isVerbatimSuperpowersMarkdownPath(rel) {
-  return rel.replace(/\\/g, "/").includes("/superpowers/");
-}
+var REQUIRED_SKILL_FRONTMATTER = validation_rules_default.requiredSkillFrontmatter;
 var REQUIRED_AGENT_SECTIONS = validation_rules_default.requiredAgentSections;
 var RISKY_INSTALL_PATTERNS = validation_rules_default.riskyInstallPatterns.map(toRegExp);
 var ALLOWED_NPX_PATTERN = toRegExp(validation_rules_default.allowedNpxPattern);
@@ -3819,7 +3859,7 @@ async function runUninstall(options = {}) {
       continue;
     }
     await fs17.remove(entry.destPath);
-    await pruneEmptyDir(path23.dirname(entry.destPath));
+    await pruneEmptyDir2(path23.dirname(entry.destPath));
     result.deleted.push(entry.destPath);
   }
   const settings = await readSettings();
@@ -3850,7 +3890,7 @@ function printUninstallResult(result) {
     log("Haus hook entries removed from ~/.claude/settings.json");
   }
 }
-async function pruneEmptyDir(dir) {
+async function pruneEmptyDir2(dir) {
   try {
     const entries = await fs17.readdir(dir);
     if (entries.length === 0) await fs17.remove(dir);
@@ -4086,8 +4126,33 @@ function extractUseWhenSection(text) {
   const next = tail.search(/\n##\s+/);
   return next < 0 ? tail : tail.slice(0, next);
 }
+function isYamlBlockScalarHeader(rest) {
+  return /^[>|][-+]?(\d+)?(?:\s+#.*)?$/.test(rest);
+}
+function extractFrontmatterDescription(text) {
+  const m = text.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!m) return "";
+  const lines = m[1].split(/\r?\n/);
+  const idx = lines.findIndex((l) => /^description:[ \t]*/.test(l));
+  if (idx < 0) return "";
+  const rest = lines[idx].replace(/^description:[ \t]*/, "").trim();
+  if (!rest) return "";
+  if (!isYamlBlockScalarHeader(rest)) {
+    return rest.replace(/^["']|["']$/g, "").trim();
+  }
+  const body = [];
+  for (let j = idx + 1; j < lines.length; j++) {
+    const line2 = lines[j];
+    if (/^[a-zA-Z_][\w.-]*:[ \t]/.test(line2)) break;
+    if (line2.trim() === "") continue;
+    if (/^\s+/.test(line2)) body.push(line2.trimStart());
+    else break;
+  }
+  return body.join(" ").replace(/\s+/g, " ").trim();
+}
 function auditForbiddenTagsInText(text, label) {
-  const body = extractUseWhenSection(text);
+  const body = `${extractFrontmatterDescription(text)}
+${extractUseWhenSection(text)}`;
   if (!body.trim()) return [];
   const failures = [];
   for (const word of PROSE_FORBIDDEN_TAGS) {
@@ -4173,10 +4238,10 @@ function auditShippedFiles(manifestDir, items) {
         continue;
       }
       const text = fs18.readFileSync(skillMd, "utf8");
-      const skillSectionExempt = SKILL_SECTION_EXEMPT_SOURCES.includes(item.source) && item.whenToUse && item.whenNotToUse;
-      if (!skillSectionExempt) {
-        for (const section of REQUIRED_SKILL_SECTIONS) {
-          if (!text.includes(section)) failures.push(`${item.id}: SKILL.md missing ${section}`);
+      const description = extractFrontmatterDescription(text);
+      for (const key of REQUIRED_SKILL_FRONTMATTER) {
+        if (key === "description" && !description) {
+          failures.push(`${item.id}: SKILL.md missing non-empty frontmatter 'description:'`);
         }
       }
       failures.push(
@@ -4245,13 +4310,9 @@ function auditMarkdownContent(manifestDir) {
     walkMd(abs, (file) => {
       const text = fs18.readFileSync(file, "utf8");
       const rel = path26.relative(manifestDir, file);
-      if (isVerbatimSuperpowersMarkdownPath(rel)) return;
       const lines = text.split(/\r?\n/);
       for (let i = 0; i < lines.length; i++) {
         const line2 = lines[i] ?? "";
-        if (PLACEHOLDER_PATTERN.test(line2)) {
-          failures.push(`${rel}:${i + 1}: TODO or placeholder in shipped content`);
-        }
         if (RISKY_INSTALL_PATTERNS.some((re) => re.test(line2))) {
           failures.push(`${rel}:${i + 1}: risky install pattern`);
         }

package/library/catalog/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.5.0",
+  "version": "2.6.1",
   "items": [
     {
       "id": "haus.nextjs-patterns",
@@ -1650,7 +1650,7 @@
     },
     {
       "id": "haus.superpowers-brainstorming",
-      "version": "1.0.1",
+      "version": "1.0.2",
       "source": "curated",
       "type": "skill",
       "path": "skills/superpowers/brainstorming",

package/library/catalog/validation-rules.json

@@ -17,7 +17,7 @@
     "trading"
   ],
   "bannedAgentPhrases": ["autonomous", "swarm", "delegate", "orchestrat", "marketplace"],
-  "requiredSkillSections": ["## Use when", "## Do not use when"],
+  "requiredSkillFrontmatter": ["description"],
   "requiredAgentSections": ["## Use when", "## Do not use when", "## Verification"],
   "riskyInstallPatterns": [
     { "source": "\\bnpx\\s+-y\\b", "flags": "i" },
@@ -142,6 +142,5 @@
     "baseline",
     "project-instructions"
   ],
-  "patternTagSuffixes": ["-patterns"],
-  "skillSectionExemptSources": ["curated"]
+  "patternTagSuffixes": ["-patterns"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haus-tech/haus-workflow",
-  "version": "0.17.1",
+  "version": "0.18.1",
   "description": "Haus AI workflow CLI for Claude Code.",
   "type": "module",
   "bin": {

package/tests/fixtures/catalog/skills/auth-oidc-azure-bankid-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/bullmq-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/database-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/dotnet-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/dotnet-service-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/eslint-setup/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/expo-react-native-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/global-engineering-rules/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/i18next-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/jest-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/laravel-nova-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/laravel-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/nestjs-graphql-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/nextauth-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/nextjs-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/nx21-monorepo-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/package-manager-yarn4-pnpm89/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/phpunit-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/playwright-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/prettier-setup/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/prisma-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/production-readiness-review/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/qliro-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/radix-shadcn-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/react-router-v7-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/react19-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/sanity-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/security-review/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/sentry-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/storybook-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/strapi-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/stripe-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/supabase-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/tailwind-scss-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/tanstack-query-router-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/testing-library-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/turbo-monorepo-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/typescript5-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/vendure-app-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/vendure-plugin-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/vite8-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/vitest-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/vue-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/wordpress-acf-elementor-jetengine-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/wordpress-bedrock-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when
 

package/tests/fixtures/catalog/skills/wordpress-patterns/SKILL.md

@@ -1,4 +1,9 @@
-<!-- Fixture stub — minimal valid SKILL.md for CLI tests. -->
+---
+name: fixture-stub
+description: Fixture stub — minimal valid SKILL.md for CLI tests.
+---
+
+# Fixture stub
 
 ## Use when