@rune-kit/rune 2.22.2 → 2.24.0

package/compiler/adapters/copilot.js

@@ -1,19 +1,17 @@
 /**
- * GitHub Copilot CLI Adapter
+ * GitHub Copilot Adapter
  *
- * Emits per-skill instruction files into .github/instructions/ — the documented
- * convention for GitHub Copilot custom instructions (read by both the CLI and
- * the GitHub Copilot IDE plugin family).
+ * Emits SKILL.md files into .github/skills/{name}/ directories — GitHub
+ * Copilot's native Agent Skills format (supported since Dec 2025 across
+ * Copilot CLI, VS Code agent mode, and github.com). Skills are loaded
+ * on-demand based on the description, keeping context lean.
  *
- * Copilot instructions dir: .github/instructions/
- * Copilot instruction file: .github/instructions/rune-{name}.instructions.md
+ * Copilot skills dir: .github/skills/ (also reads .claude/skills and .agents/skills)
+ * Copilot skill format: .github/skills/{name}/SKILL.md
  * Copilot project context: AGENTS.md (Copilot Spaces / Coding Agent convention)
  *
- * Each .instructions.md uses YAML frontmatter with `applyTo` for path scoping.
- * Default applyTo: "**" means "apply to all files."
- *
- * @see https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-custom-instructions
- * @see https://docs.github.com/en/copilot/concepts/response-customization
+ * @see https://docs.github.com/en/copilot/concepts/agents/about-agent-skills
+ * @see https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-skills
  *
  * MODEL TIER MAPPING (v2.18+):
  * Copilot multi-model support exposes Anthropic/OpenAI/Google providers. Tier
@@ -37,23 +35,24 @@ const TOOL_MAP = {
   Grep: 'search file contents',
   Bash: 'run a shell command',
   TodoWrite: 'track task progress',
-  Skill: 'follow the referenced instructions',
+  Skill: 'invoke the named skill',
   Agent: 'execute the workflow',
 };
 
 export default {
   name: 'copilot',
-  outputDir: '.github/instructions',
-  fileExtension: '.instructions.md',
+  outputDir: '.github/skills',
+  fileExtension: '.md',
   skillPrefix: 'rune-',
   skillSuffix: '',
 
-  // Copilot instructions are flat per-skill files, not directories.
-  useSkillDirectories: false,
+  // Copilot uses directory-per-skill: .github/skills/{name}/SKILL.md
+  useSkillDirectories: true,
+  skillFileName: 'SKILL.md',
 
   transformReference(skillName, raw) {
     const isBackticked = raw.startsWith('`') && raw.endsWith('`');
-    const ref = `the rune-${skillName} instructions`;
+    const ref = `the rune-${skillName} skill`;
     return isBackticked ? `\`${ref}\`` : ref;
   },
 
@@ -62,15 +61,13 @@ export default {
   },
 
   generateHeader(skill) {
-    // Per docs.github.com Copilot CLI custom-instructions spec, the only
-    // documented frontmatter key for `.instructions.md` is `applyTo`. Other
-    // metadata (description, tier hint) belongs in the markdown body so it
-    // survives parsing across CLI/IDE/extensions consistently.
-    const desc = (skill.description || '').replace(/\n/g, ' ');
+    // Agent Skills spec: name + description frontmatter, markdown body.
+    // Tier hint stays a body comment — Copilot has no model frontmatter key.
+    const desc = (skill.description || '').replace(/"/g, '\\"');
     const tierHint = skill.model ? MODEL_MAP[skill.model] || skill.model : null;
-    const lines = ['---', 'applyTo: "**"', '---', '', `# rune-${skill.name}`, '', `> ${desc}`];
-    if (tierHint) lines.push('', `<!-- tier-hint: ${tierHint} -->`);
-    lines.push('', '');
+    const lines = ['---', `name: rune-${skill.name}`, `description: "${desc}"`, '---', ''];
+    if (tierHint) lines.push(`<!-- tier-hint: ${tierHint} -->`, '');
+    lines.push('');
     return lines.join('\n');
   },
 
@@ -83,7 +80,7 @@ export default {
   },
 
   scriptsDir(skillName) {
-    return `rune-${skillName}-scripts`;
+    return `rune-${skillName}/scripts`;
   },
 
   postProcess(content) {
@@ -96,9 +93,9 @@ export default {
     const copilotIndex = [
       '# Rune — Copilot Custom Instructions',
       '',
-      `Per-skill instructions live under \`.github/instructions/rune-<name>.instructions.md\` (${stats.skillCount} skills + ${stats.packCount} packs). Copilot loads them based on each file's \`applyTo\` glob.`,
+      `Per-skill Agent Skills live under \`.github/skills/rune-<name>/SKILL.md\` (${stats.skillCount} skills + ${stats.packCount} packs). Copilot discovers and loads them on demand based on each skill's description.`,
       '',
-      'When a user request matches a skill\'s domain (e.g. "fix the failing test", "review this PR"), prefer following the corresponding rune-<name>.instructions.md over freestyling.',
+      'When a user request matches a skill\'s domain (e.g. "fix the failing test", "review this PR"), prefer invoking the corresponding rune-<name> skill over freestyling.',
       '',
       '---',
       '> Rune Skill Mesh — https://github.com/rune-kit/rune',
@@ -111,7 +108,7 @@ export default {
       'Rune is an interconnected skill ecosystem for AI coding assistants.',
       `${stats.skillCount} core skills + ${stats.packCount} extension packs.`,
       '',
-      'Per-skill custom instructions: `.github/instructions/rune-<name>.instructions.md`',
+      'Per-skill Agent Skills: `.github/skills/rune-<name>/SKILL.md`',
       '',
       '---',
       '> Rune Skill Mesh — https://github.com/rune-kit/rune',

package/compiler/adapters/cursor.js

@@ -1,8 +1,18 @@
 /**
  * Cursor Adapter
  *
- * Emits .mdc rule files for .cursor/rules/ directory.
- * Uses @file references for cross-skill mesh.
+ * Emits SKILL.md files into .cursor/skills/{name}/ directories — Cursor's
+ * native Agent Skills format (Cursor 2.4+, Jan 2026). Skills are loaded
+ * dynamically when the agent decides they're relevant, unlike .cursor/rules
+ * which are always-on context.
+ *
+ * Cursor skills dir: .cursor/skills/
+ * Cursor skill format: .cursor/skills/{name}/SKILL.md
+ * @see https://cursor.com/docs/skills
+ *
+ * NOTE: .cursor/rules/ is still used by the runtime-hooks installer
+ * (adapters/hooks/cursor.js) — rules are the correct vehicle for always-on
+ * hook context. Only skill emission moved to .cursor/skills/.
  *
  * MODEL TIER MAPPING (v2.15+):
  * No-op. Cursor's Anthropic API integration understands `model: opus|sonnet|haiku`
@@ -19,20 +29,24 @@ const TOOL_MAP = {
   Grep: 'search file contents',
   Bash: 'run a terminal command',
   TodoWrite: 'track progress',
-  Skill: 'follow the referenced skill rules',
+  Skill: 'invoke the named skill',
   Agent: 'execute the workflow',
 };
 
 export default {
   name: 'cursor',
-  outputDir: '.cursor/rules',
-  fileExtension: '.mdc',
+  outputDir: '.cursor/skills',
+  fileExtension: '.md',
   skillPrefix: 'rune-',
   skillSuffix: '',
 
+  // Cursor uses directory-per-skill: .cursor/skills/{name}/SKILL.md
+  useSkillDirectories: true,
+  skillFileName: 'SKILL.md',
+
   transformReference(skillName, raw) {
     const isBackticked = raw.startsWith('`') && raw.endsWith('`');
-    const ref = `@rune-${skillName}.mdc`;
+    const ref = `the rune-${skillName} skill`;
     return isBackticked ? `\`${ref}\`` : ref;
   },
 
@@ -41,14 +55,8 @@ export default {
   },
 
   generateHeader(skill) {
-    return [
-      '---',
-      `description: "${skill.description}"`,
-      'globs: []',
-      `alwaysApply: ${skill.layer === 'L0'}`,
-      '---',
-      '',
-    ].join('\n');
+    const desc = (skill.description || '').replace(/"/g, '\\"');
+    return ['---', `name: rune-${skill.name}`, `description: "${desc}"`, '---', '', ''].join('\n');
   },
 
   generateFooter() {
@@ -60,7 +68,7 @@ export default {
   },
 
   scriptsDir(skillName) {
-    return `rune-${skillName}-scripts`;
+    return `rune-${skillName}/scripts`;
   },
 
   postProcess(content) {

package/compiler/adapters/gemini.js

@@ -1,27 +1,25 @@
 /**
  * Gemini CLI Adapter
  *
- * Gemini CLI loads a single GEMINI.md at project root for context. It does NOT
- * support per-skill imports as of writing — so the canonical output is a
- * bundled GEMINI.md with every skill concatenated under `## rune-<name>` H2
- * sections. Per-skill files are still emitted under gemini/skills/ for human
- * inspection and forward-compatibility if Gemini adds @import support later.
+ * Emits SKILL.md files into .gemini/skills/{name}/ directories — Gemini CLI's
+ * native Agent Skills format. Gemini CLI discovers skills automatically from
+ * .gemini/skills/ (and the .agents/skills/ interop alias) and lazy-loads the
+ * full SKILL.md only when a skill is invoked — no more bundling every skill
+ * into GEMINI.md (which loaded all 65 skills as always-on context).
  *
- * Gemini context file: GEMINI.md (project root)
- * Gemini per-skill files: gemini/skills/rune-{name}.md (forward-compat staging)
+ * Gemini skills dir: .gemini/skills/
+ * Gemini skill format: .gemini/skills/{name}/SKILL.md
+ * Gemini project context: GEMINI.md (slim pointer, project root)
  *
- * @see https://github.com/google-gemini/gemini-cli
- * @see https://geminicli.com/docs/reference/configuration/
+ * @see https://geminicli.com/docs/cli/skills/
+ * @see https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/skills.md
  *
  * MODEL TIER MAPPING (v2.18+):
- * Gemini CLI exposes 1.5 Pro / 1.5 Flash / 2.0 Flash etc. Anthropic tier names
- * translate to Gemini families: opus→1.5-pro, sonnet→1.5-flash, haiku→
- * 2.0-flash-lite. Hint only — Gemini CLI reads model from --model flag /
- * config, not from rule body.
+ * Gemini CLI exposes Pro / Flash / Flash-Lite families. Anthropic tier names
+ * translate to Gemini families as a hint comment — Gemini CLI reads model
+ * from --model flag / config, not from the skill body.
  */
 
-import { readFile } from 'node:fs/promises';
-import nodePath from 'node:path';
 import { BRANDING_FOOTER } from '../transforms/branding.js';
 
 const MODEL_MAP = {
@@ -38,23 +36,24 @@ const TOOL_MAP = {
   Grep: 'search file contents',
   Bash: 'run a shell command',
   TodoWrite: 'track task progress',
-  Skill: 'follow the referenced rune-{name} section in GEMINI.md',
+  Skill: 'invoke the rune-{name} skill',
   Agent: 'execute the workflow',
 };
 
 export default {
   name: 'gemini',
-  outputDir: 'gemini/skills',
+  outputDir: '.gemini/skills',
   fileExtension: '.md',
   skillPrefix: 'rune-',
   skillSuffix: '',
 
-  // Per-skill files staged for forward compat; canonical entry is bundled GEMINI.md.
-  useSkillDirectories: false,
+  // Gemini CLI uses directory-per-skill: .gemini/skills/{name}/SKILL.md
+  useSkillDirectories: true,
+  skillFileName: 'SKILL.md',
 
   transformReference(skillName, raw) {
     const isBackticked = raw.startsWith('`') && raw.endsWith('`');
-    const ref = `the rune-${skillName} section in GEMINI.md`;
+    const ref = `the rune-${skillName} skill`;
     return isBackticked ? `\`${ref}\`` : ref;
   },
 
@@ -80,46 +79,24 @@ export default {
   },
 
   scriptsDir(skillName) {
-    return `rune-${skillName}-scripts`;
+    return `rune-${skillName}/scripts`;
   },
 
   postProcess(content) {
     return content.replace(/^context: fork\n/gm, '').replace(/^agent: general-purpose\n/gm, '');
   },
 
-  // Bundle every per-skill file into a single GEMINI.md with H2 section per skill.
-  // Gemini CLI loads GEMINI.md from project root as its context file. Hook contract
-  // requires relative paths (resolved against outputRoot by the emitter).
-  async generateExtraFiles({ stats, outputDir }) {
-    const skillFiles = [...stats.files]
-      .filter((f) => f.startsWith('rune-') && f.endsWith('.md') && !f.includes('/') && !f.includes('\\'))
-      .sort();
-
-    const sections = [];
-    for (const fname of skillFiles) {
-      const sourcePath = nodePath.join(outputDir, fname);
-      try {
-        const raw = await readFile(sourcePath, 'utf-8');
-        // Strip frontmatter — Gemini reads plain markdown.
-        const stripped = raw.replace(/^---\n[\s\S]*?\n---\n?/, '').trim();
-        const skillName = fname.replace(/^rune-/, '').replace(/\.md$/, '');
-        sections.push(`\n\n## rune-${skillName}\n\n${stripped}`);
-      } catch {
-        // Skip unreadable per-skill file — sections array still produces valid bundle.
-      }
-    }
-
+  // Slim GEMINI.md pointer — skills themselves are lazy-loaded natively.
+  generateExtraFiles({ stats }) {
     const geminiMd = [
       '# Rune — Project Configuration',
       '',
       'Rune is an interconnected skill ecosystem for AI coding assistants.',
-      `${stats.skillCount} core skills + ${stats.packCount} extension packs, bundled below.`,
-      '',
-      'When a user request matches a skill\'s domain (e.g. "implement", "review", "debug"), follow the matching `## rune-<name>` section.',
+      `${stats.skillCount} core skills + ${stats.packCount} extension packs.`,
       '',
-      '> Per-skill files are staged in `gemini/skills/` for forward-compat if Gemini CLI adds @import support.',
+      'Per-skill Agent Skills live under `.gemini/skills/rune-<name>/SKILL.md`. Gemini CLI discovers and lazy-loads them automatically.',
       '',
-      ...sections,
+      'When a user request matches a skill\'s domain (e.g. "implement", "review", "debug"), invoke the matching rune-<name> skill.',
       '',
       '---',
       '> Rune Skill Mesh — https://github.com/rune-kit/rune',

package/compiler/adapters/qoder.js

@@ -1,14 +1,15 @@
 /**
  * Qoder Adapter
  *
- * Emits per-skill rule files into .qoder/rules/ — Qoder's documented project-level
- * rule directory. Qoder also reads AGENTS.md as its project-context file.
+ * Emits SKILL.md files into .qoder/skills/{name}/ directories — Qoder's
+ * documented project-level Agent Skills location (works identically in
+ * Qoder IDE and CLI). Qoder also reads AGENTS.md as its project-context file.
  *
- * Qoder rules dir: .qoder/rules/
- * Qoder rule file: .qoder/rules/rune-{name}.md (one file per skill)
+ * Qoder skills dir: .qoder/skills/
+ * Qoder skill format: .qoder/skills/{name}/SKILL.md
  * Qoder project context: AGENTS.md (open AGENTS.md standard)
  *
- * @see https://docs.qoder.com/user-guide/rules
+ * @see https://docs.qoder.com/extensions/skills
  * @see https://agents.md/
  *
  * MODEL TIER MAPPING (v2.18+):
@@ -32,23 +33,24 @@ const TOOL_MAP = {
   Grep: 'search file contents',
   Bash: 'run a shell command',
   TodoWrite: 'track task progress',
-  Skill: 'follow the referenced rune-{name} rule',
+  Skill: 'invoke the rune-{name} skill',
   Agent: 'execute the workflow',
 };
 
 export default {
   name: 'qoder',
-  outputDir: '.qoder/rules',
+  outputDir: '.qoder/skills',
   fileExtension: '.md',
   skillPrefix: 'rune-',
   skillSuffix: '',
 
-  // Qoder rules are flat .md files, not directory-per-skill
-  useSkillDirectories: false,
+  // Qoder uses directory-per-skill: .qoder/skills/{name}/SKILL.md
+  useSkillDirectories: true,
+  skillFileName: 'SKILL.md',
 
   transformReference(skillName, raw) {
     const isBackticked = raw.startsWith('`') && raw.endsWith('`');
-    const ref = `the rune-${skillName} rule`;
+    const ref = `the rune-${skillName} skill`;
     return isBackticked ? `\`${ref}\`` : ref;
   },
 
@@ -74,7 +76,7 @@ export default {
   },
 
   scriptsDir(skillName) {
-    return `rune-${skillName}-scripts`;
+    return `rune-${skillName}/scripts`;
   },
 
   postProcess(content) {
@@ -89,9 +91,7 @@ export default {
       'Rune is an interconnected skill ecosystem for AI coding assistants.',
       `${stats.skillCount} core skills + ${stats.packCount} extension packs.`,
       '',
-      'Per-skill rules live under `.qoder/rules/rune-<name>.md`. Qoder loads them automatically.',
-      '',
-      'Reference a skill by name (e.g. "follow the rune-cook rule") inside any chat — the rule file is auto-injected.',
+      'Per-skill Agent Skills live under `.qoder/skills/rune-<name>/SKILL.md`. Qoder discovers and loads them on demand.',
       '',
       '---',
       '> Rune Skill Mesh — https://github.com/rune-kit/rune',

package/compiler/adapters/qwen.js

@@ -1,15 +1,16 @@
 /**
  * Qwen Coder Adapter
  *
- * Emits per-skill rule files into qwen/skills/ and a top-level QWEN.md that
- * uses Qwen Code's @import syntax to load each rule file. Qwen Code loads
- * QWEN.md hierarchically (cwd → parent → ~/.qwen/QWEN.md).
+ * Emits SKILL.md files into .qwen/skills/{name}/ directories — Qwen Code's
+ * native Agent Skills format. Qwen Code discovers project skills from
+ * .qwen/skills/ and lazy-loads them on demand (browse via /skills) — no more
+ * QWEN.md @import lines that loaded every skill as always-on context.
  *
- * Qwen rules dir: qwen/skills/
- * Qwen rule file: qwen/skills/rune-{name}.md
- * Qwen project context: QWEN.md at project root (with @path imports)
+ * Qwen skills dir: .qwen/skills/
+ * Qwen skill format: .qwen/skills/{name}/SKILL.md
+ * Qwen project context: QWEN.md (slim pointer, loaded hierarchically)
  *
- * @see https://qwenlm.github.io/qwen-code-docs/en/users/configuration/settings/
+ * @see https://qwenlm.github.io/qwen-code-docs/en/users/features/skills/
  * @see https://github.com/QwenLM/qwen-code
  *
  * MODEL TIER MAPPING (v2.18+):
@@ -34,19 +35,20 @@ const TOOL_MAP = {
   Grep: 'search file contents',
   Bash: 'run a shell command',
   TodoWrite: 'track task progress',
-  Skill: 'follow the imported rune-{name} skill',
+  Skill: 'invoke the rune-{name} skill',
   Agent: 'execute the workflow',
 };
 
 export default {
   name: 'qwen',
-  outputDir: 'qwen/skills',
+  outputDir: '.qwen/skills',
   fileExtension: '.md',
   skillPrefix: 'rune-',
   skillSuffix: '',
 
-  // Qwen skills are flat per-skill markdown files imported from QWEN.md.
-  useSkillDirectories: false,
+  // Qwen Code uses directory-per-skill: .qwen/skills/{name}/SKILL.md
+  useSkillDirectories: true,
+  skillFileName: 'SKILL.md',
 
   transformReference(skillName, raw) {
     const isBackticked = raw.startsWith('`') && raw.endsWith('`');
@@ -76,30 +78,22 @@ export default {
   },
 
   scriptsDir(skillName) {
-    return `rune-${skillName}-scripts`;
+    return `rune-${skillName}/scripts`;
   },
 
   postProcess(content) {
     return content.replace(/^context: fork\n/gm, '').replace(/^agent: general-purpose\n/gm, '');
   },
 
-  // Emit QWEN.md at project root with @import lines for every per-skill file.
+  // Slim QWEN.md pointer — skills themselves are lazy-loaded natively.
   generateExtraFiles({ stats }) {
-    const skillFiles = stats.files
-      .filter((f) => f.startsWith('rune-') && f.endsWith('.md') && !f.includes('/') && !f.includes('\\'))
-      .sort();
-
     const qwenMd = [
       '# Rune — Project Configuration',
       '',
       'Rune is an interconnected skill ecosystem for AI coding assistants.',
       `${stats.skillCount} core skills + ${stats.packCount} extension packs.`,
       '',
-      '## Loaded Skills',
-      '',
-      'Qwen Code loads each referenced file as part of this project context.',
-      '',
-      ...skillFiles.map((f) => `@qwen/skills/${f}`),
+      'Per-skill Agent Skills live under `.qwen/skills/rune-<name>/SKILL.md`. Qwen Code discovers and lazy-loads them on demand (browse via /skills).',
       '',
       '---',
       '> Rune Skill Mesh — https://github.com/rune-kit/rune',

package/compiler/adapters/windsurf.js

@@ -1,8 +1,25 @@
 /**
  * Windsurf Adapter
  *
- * Emits .md rule files for .windsurf/rules/ directory.
- * Uses prose references for cross-skill mesh (no @file support).
+ * Emits SKILL.md files into .windsurf/skills/{name}/ directories — the native
+ * Cascade Skills format. Cascade uses progressive disclosure: only the skill's
+ * name and description are shown to the model by default; the full SKILL.md is
+ * loaded when Cascade invokes the skill (or via @skill-name).
+ *
+ * REBRAND (2026-06-02): Windsurf is now "Devin Desktop" (Cognition), rolled out
+ * over-the-air. Devin Desktop PREFERS `.devin/skills/` + `.devin/rules/` but
+ * still reads `.windsurf/skills/` + `.windsurf/rules/` as a documented fallback
+ * (docs.devin.ai). Rune keeps emitting to `.windsurf/` for maximum compat — it
+ * works on both current Devin and any un-migrated Windsurf install. The CLI flag
+ * stays `--platform windsurf`. Flip the emission dirs to `.devin/` only once
+ * Devin deprecates the `.windsurf/` fallback. @see docs.devin.ai/desktop
+ *
+ * Windsurf/Devin skills dir: .windsurf/skills/  (Devin also reads .devin/skills/)
+ * Skill format: .windsurf/skills/{name}/SKILL.md
+ *
+ * NOTE: .windsurf/rules/ is still used by the runtime-hooks installer
+ * (adapters/hooks/windsurf.js) — rules are the correct vehicle for always-on
+ * hook context. Only skill emission moved to .windsurf/skills/.
  *
  * MODEL TIER MAPPING (v2.15+):
  * No-op. Windsurf's Anthropic API integration understands `model: opus|sonnet|haiku`
@@ -19,20 +36,24 @@ const TOOL_MAP = {
   Grep: 'search for text in files',
   Bash: 'run a shell command',
   TodoWrite: 'track task progress',
-  Skill: 'follow the referenced skill workflow',
+  Skill: 'invoke the named skill',
   Agent: 'execute the workflow',
 };
 
 export default {
   name: 'windsurf',
-  outputDir: '.windsurf/rules',
+  outputDir: '.windsurf/skills',
   fileExtension: '.md',
   skillPrefix: 'rune-',
   skillSuffix: '',
 
+  // Windsurf uses directory-per-skill: .windsurf/skills/{name}/SKILL.md
+  useSkillDirectories: true,
+  skillFileName: 'SKILL.md',
+
   transformReference(skillName, raw) {
     const isBackticked = raw.startsWith('`') && raw.endsWith('`');
-    const ref = `the rune-${skillName} rule file`;
+    const ref = `the rune-${skillName} skill`;
     return isBackticked ? `\`${ref}\`` : ref;
   },
 
@@ -41,7 +62,8 @@ export default {
   },
 
   generateHeader(skill) {
-    return `# rune-${skill.name}\n\n> Layer: ${skill.layer} | Group: ${skill.group}\n\n`;
+    const desc = (skill.description || '').replace(/"/g, '\\"');
+    return ['---', `name: rune-${skill.name}`, `description: "${desc}"`, '---', '', ''].join('\n');
   },
 
   generateFooter() {
@@ -53,7 +75,7 @@ export default {
   },
 
   scriptsDir(skillName) {
-    return `rune-${skillName}-scripts`;
+    return `rune-${skillName}/scripts`;
   },
 
   postProcess(content) {

package/compiler/emitter.js

@@ -65,7 +65,7 @@ async function discoverPacks(extensionsDir, enabledPacks = null) {
  * Copies directories except SKILL.md (already processed) and denylisted dirs
  *
  * @param {string} sourceSkillDir - e.g. skills/cook/
- * @param {string} outputSkillDir - e.g. .codex/skills/rune-cook/
+ * @param {string} outputSkillDir - e.g. .agents/skills/rune-cook/
  * @returns {Promise<string[]>} list of copied directory names
  */
 const COPY_DENYLIST = new Set(['.git', 'node_modules', '__pycache__', '.DS_Store', '.venv', '.env']);
@@ -74,7 +74,8 @@ async function copySkillExtraDirs(sourceSkillDir, outputSkillDir) {
   if (!existsSync(sourceSkillDir)) return [];
 
   const entries = await readdir(sourceSkillDir, { withFileTypes: true });
-  const dirs = entries.filter((e) => e.isDirectory() && !COPY_DENYLIST.has(e.name));
+  // scripts/ is excluded: copyScriptsDir handles it explicitly (with stats counting)
+  const dirs = entries.filter((e) => e.isDirectory() && !COPY_DENYLIST.has(e.name) && e.name !== 'scripts');
 
   const copied = [];
   for (const dir of dirs) {
@@ -91,7 +92,7 @@ async function copySkillExtraDirs(sourceSkillDir, outputSkillDir) {
  * Copy scripts directory from skill source to output.
  *
  * @param {string} sourceScriptsDir - e.g. skills/slides/scripts/
- * @param {string} outputScriptsDir - e.g. .cursor/rules/rune-slides-scripts/
+ * @param {string} outputScriptsDir - e.g. .cursor/skills/rune-slides/scripts/
  * @returns {Promise<string[]>} list of copied file paths
  */
 async function copyScriptsDir(sourceScriptsDir, outputScriptsDir) {
@@ -524,7 +525,7 @@ export async function buildAll({
       let skillDir = null;
 
       if (adapter.useSkillDirectories) {
-        // Directory-per-skill: .codex/skills/rune-{name}/SKILL.md
+        // Directory-per-skill: .agents/skills/rune-{name}/SKILL.md
         const dirName = `${adapter.skillPrefix}${parsed.name}`;
         skillDir = path.join(outputDir, dirName);
         await mkdir(skillDir, { recursive: true });

package/compiler/parser.js

@@ -34,6 +34,15 @@ function parseFrontmatter(content) {
   let nestedKey = null;
   const _nestedObj = {};
 
+  // Strip outer quotes; for double-quoted scalars also unescape interior \"
+  // so consumers (adapter generateHeader) hold clean text and can re-escape
+  // exactly once. Without this, `\"` survives into skill.description and a
+  // later .replace(/"/g, '\\"') turns it into `\\"` — invalid YAML.
+  const parseScalar = (rawValue) => {
+    const stripped = rawValue.replace(/^["']|["']$/g, '');
+    return rawValue.startsWith('"') ? stripped.replace(/\\"/g, '"') : stripped;
+  };
+
   for (const line of raw.split('\n')) {
     const trimmed = line.trim();
     if (!trimmed) continue;
@@ -60,7 +69,7 @@ function parseFrontmatter(content) {
 
       const kvMatch = trimmed.match(/^(\w[\w-]*):\s*(.+)$/);
       if (kvMatch) {
-        const rawValue = kvMatch[2].replace(/^["']|["']$/g, '');
+        const rawValue = parseScalar(kvMatch[2]);
         // Comma-separated list fields → parse as array
         if (COMMA_LIST_FIELDS.has(kvMatch[1])) {
           frontmatter[nestedKey][kvMatch[1]] = rawValue
@@ -79,7 +88,7 @@ function parseFrontmatter(content) {
     nestedKey = null;
     const kvMatch = trimmed.match(/^(\w[\w-]*):\s*(.+)$/);
     if (kvMatch) {
-      const value = kvMatch[2].replace(/^["']|["']$/g, '');
+      const value = parseScalar(kvMatch[2]);
       // Comma-separated list fields at top level too (Pro/Business packs)
       if (COMMA_LIST_FIELDS.has(kvMatch[1])) {
         frontmatter[kvMatch[1]] = value

package/extensions/ai-ml/skills/llm-architect.md

@@ -64,21 +64,21 @@ interface ModelConfig {
 
 const MODELS: Record<string, ModelConfig> = {
   fast: {
-    id: 'claude-haiku-4-5-20251001',
+    id: 'claude-haiku-4-5',
     provider: 'anthropic',
     costPer1kTokens: 0.001,
     maxTokens: 4096,
     latencyP50Ms: 200,
   },
   balanced: {
-    id: 'claude-sonnet-4-6',
+    id: 'claude-sonnet-5',
     provider: 'anthropic',
     costPer1kTokens: 0.01,
     maxTokens: 8192,
     latencyP50Ms: 800,
   },
   deep: {
-    id: 'claude-opus-4-6',
+    id: 'claude-opus-4-8',
     provider: 'anthropic',
     costPer1kTokens: 0.05,
     maxTokens: 16384,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rune-kit/rune",
-  "version": "2.22.2",
+  "version": "2.24.0",
   "description": "65-skill mesh for AI coding assistants — runtime auto-discipline via native hooks (Claude/Cursor/Windsurf/Antigravity), 5-layer architecture, 204 connections + 43 signals, multi-platform compiler. converge (L3) scans spec vs code so dead-button/frontend-only implementations can't ship.",
   "type": "module",
   "bin": {