Improve critique skill reliability

- add provider-specific block compilation and tests

- bundle detector scripts for skill critique runs

- harden critique orchestration, browser handling, and storage

scripts/lib/transformers/factory.js

@@ -1,5 +1,13 @@
 import path from 'path';
-import { cleanDir, ensureDir, writeFile, generateYamlFrontmatter, generateYamlDocument, replacePlaceholders } from '../utils.js';
+import {
+  cleanDir,
+  ensureDir,
+  writeFile,
+  generateYamlFrontmatter,
+  generateYamlDocument,
+  replacePlaceholders,
+  compileProviderBlocks,
+} from '../utils.js';
 import { SKILL_CATEGORIES, CATEGORY_ORDER } from '../sub-pages-data.js';
 
 /**
@@ -138,7 +146,17 @@ function buildAgentFile(config, agent, body) {
  * @returns {Function} transform(skills, distDir, options?)
  */
 export function createTransformer(config) {
-  const { provider, configDir, displayName, frontmatterFields = [], bodyTransform, placeholderProvider, writeOpenAIMetadata = false, includeVersion = true } = config;
+  const {
+    provider,
+    configDir,
+    displayName,
+    frontmatterFields = [],
+    bodyTransform,
+    placeholderProvider,
+    providerTags = [provider],
+    writeOpenAIMetadata = false,
+    includeVersion = true,
+  } = config;
   const placeholderKey = placeholderProvider || provider;
 
   const activeFields = frontmatterFields
@@ -200,7 +218,8 @@ export function createTransformer(config) {
       const frontmatter = generateYamlFrontmatter(frontmatterObj);
 
       // Build body
-      let skillBody = replacePlaceholders(skill.body, placeholderKey, commandNames, allSkillNames);
+      let skillBody = compileProviderBlocks(skill.body, providerTags);
+      skillBody = replacePlaceholders(skillBody, placeholderKey, commandNames, allSkillNames);
 
       // Replace {{scripts_path}} with provider-aware path to skill's scripts directory
       const scriptsPath = `${configDir}/skills/${skillName}/scripts`;
@@ -220,7 +239,8 @@ export function createTransformer(config) {
         const refDir = path.join(skillDir, 'reference');
         ensureDir(refDir);
         for (const ref of skill.references) {
-          let refContent = replacePlaceholders(ref.content, placeholderKey, [], allSkillNames);
+          let refContent = compileProviderBlocks(ref.content, providerTags);
+          refContent = replacePlaceholders(refContent, placeholderKey, [], allSkillNames);
           refContent = refContent.replace(/\{\{scripts_path\}\}/g, scriptsPath);
           writeFile(path.join(refDir, `${ref.name}.md`), refContent);
           refCount++;
@@ -245,7 +265,8 @@ export function createTransformer(config) {
           // Agents can declare `providers: <list>` to limit which harnesses
           // they emit to. Default (no field) ships everywhere with agentFormat.
           if (agent.providers && !agent.providers.includes(provider)) continue;
-          const body = replacePlaceholders(agent.body, placeholderKey, [], allSkillNames);
+          let body = compileProviderBlocks(agent.body, providerTags);
+          body = replacePlaceholders(body, placeholderKey, [], allSkillNames);
           const agentFile = buildAgentFile(config, agent, body);
           if (!agentFile) continue;
           ensureDir(agentsDir);

scripts/lib/transformers/providers.js

@@ -5,18 +5,21 @@
  * - provider: key into PROVIDER_PLACEHOLDERS (e.g. 'claude-code')
  * - configDir: dot-directory name (e.g. '.claude')
  * - displayName: human-readable name for log output (e.g. 'Claude Code')
+ * - providerTags: markdown block tags kept for this target (e.g. <codex>...</codex>)
  * - frontmatterFields: which optional fields to emit beyond name + description
  * - bodyTransform: optional function (body, skill) => transformed body
  */
 export const PROVIDERS = {
   cursor: {
     provider: 'cursor',
+    providerTags: ['cursor'],
     configDir: '.cursor',
     displayName: 'Cursor',
     frontmatterFields: ['license', 'compatibility', 'metadata'],
   },
   'claude-code': {
     provider: 'claude-code',
+    providerTags: ['claude-code', 'claude'],
     configDir: '.claude',
     displayName: 'Claude Code',
     frontmatterFields: ['user-invocable', 'argument-hint', 'license', 'compatibility', 'metadata', 'allowed-tools'],
@@ -24,12 +27,14 @@ export const PROVIDERS = {
   },
   gemini: {
     provider: 'gemini',
+    providerTags: ['gemini'],
     configDir: '.gemini',
     displayName: 'Gemini',
     frontmatterFields: [],
   },
   codex: {
     provider: 'codex',
+    providerTags: ['codex'],
     configDir: '.codex',
     displayName: 'Codex',
     frontmatterFields: [],
@@ -39,6 +44,7 @@ export const PROVIDERS = {
   },
   agents: {
     provider: 'agents',
+    providerTags: ['agents', 'codex'],
     configDir: '.agents',
     displayName: 'Codex Repo Skills',
     placeholderProvider: 'codex',
@@ -48,6 +54,7 @@ export const PROVIDERS = {
   },
   github: {
     provider: 'github',
+    providerTags: ['github'],
     configDir: '.github',
     displayName: 'GitHub Copilot',
     placeholderProvider: 'agents',
@@ -55,30 +62,35 @@ export const PROVIDERS = {
   },
   kiro: {
     provider: 'kiro',
+    providerTags: ['kiro'],
     configDir: '.kiro',
     displayName: 'Kiro',
     frontmatterFields: ['license', 'compatibility', 'metadata'],
   },
   opencode: {
     provider: 'opencode',
+    providerTags: ['opencode'],
     configDir: '.opencode',
     displayName: 'OpenCode',
     frontmatterFields: ['user-invocable', 'argument-hint', 'license', 'compatibility', 'metadata', 'allowed-tools'],
   },
   pi: {
     provider: 'pi',
+    providerTags: ['pi'],
     configDir: '.pi',
     displayName: 'Pi',
     frontmatterFields: ['license', 'compatibility', 'metadata', 'allowed-tools'],
   },
   qoder: {
     provider: 'qoder',
+    providerTags: ['qoder'],
     configDir: '.qoder',
     displayName: 'Qoder',
     frontmatterFields: ['user-invocable', 'argument-hint', 'license', 'compatibility', 'metadata', 'allowed-tools'],
   },
   'trae-cn': {
     provider: 'trae-cn',
+    providerTags: ['trae-cn', 'trae'],
     configDir: '.trae-cn',
     displayName: 'Trae China',
     placeholderProvider: 'trae',
@@ -86,12 +98,14 @@ export const PROVIDERS = {
   },
   trae: {
     provider: 'trae',
+    providerTags: ['trae'],
     configDir: '.trae',
     displayName: 'Trae',
     frontmatterFields: ['user-invocable', 'argument-hint', 'license', 'compatibility', 'metadata'],
   },
   'rovo-dev': {
     provider: 'rovo-dev',
+    providerTags: ['rovo-dev'],
     configDir: '.rovodev',
     displayName: 'Rovo Dev',
     frontmatterFields: ['user-invocable', 'argument-hint', 'license', 'compatibility', 'metadata', 'allowed-tools'],