contextos-agents 1.5.0

package/.agents/adapters/copilot/export.js

@@ -0,0 +1,107 @@
+const fs = require('fs');
+const path = require('path');
+const { AGENTS_MD_PATH, collectSkillDirectories, extractYamlField, stripFrontmatter, readMeaningfulMarkdown } = require('../shared.js');
+
+// GitHub Copilot reads from .github/copilot-instructions.md
+const OUTPUT_FILE = path.join(process.cwd(), '.github', 'copilot-instructions.md');
+
+/**
+ * GitHub Copilot adapter — export.js
+ *
+ * Copilot reads `.github/copilot-instructions.md` as a plain Markdown file.
+ * We compile AGENTS.md + all skills into one document with clear section
+ * headings so Copilot can reference them contextually.
+ *
+ * Format spec: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-instructions
+ */
+
+function buildSkillSection(skillDir) {
+  const skillName  = path.basename(skillDir);
+  const skillMdPath  = path.join(skillDir, 'SKILL.md');
+  const yamlPath   = path.join(skillDir, 'skill.yaml');
+
+  let title = skillName;
+  let description = '';
+  if (fs.existsSync(yamlPath)) {
+    const yaml = fs.readFileSync(yamlPath, 'utf8');
+    title = extractYamlField(yaml, 'name') || skillName;
+    description = extractYamlField(yaml, 'description') || '';
+  }
+
+  if (!fs.existsSync(skillMdPath)) return null;
+
+  const raw = fs.readFileSync(skillMdPath, 'utf8');
+  const body = stripFrontmatter(raw);
+
+  if (!description) {
+    const firstLine = body.split(/\r?\n/).map(l => l.trim()).find(l => l && !l.startsWith('#'));
+    description = firstLine || '';
+  }
+
+  const descLine = description ? `> ${description.replace(/\r?\n+/g, ' ').trim()}\n` : '';
+  const skillRef = `*Source: \`.agents/skills/${skillName}/SKILL.md\` (Read on demand)*\n`;
+  return `\n### ${title}\n${descLine}${skillRef}`;
+}
+
+function run() {
+  console.log('Starting GitHub Copilot adapter export...');
+
+  const lines = [];
+
+  // ── Header ───────────────────────────────────────────────────────────────────
+  lines.push(
+    `# GitHub Copilot Instructions — ContextOS\n`,
+    `<!-- Auto-generated by: node .agents/ctx.js export copilot -->\n`,
+    `<!-- Source: .agents/core/skills/  ·  Do not edit manually. -->\n\n`
+  );
+
+  // ── Project rules & Step 0 ───────────────────────────────────────────────────
+  lines.push(`## Project Rules\n\n`);
+  lines.push(`### Step 0 — Identify Before Acting\n\n`);
+  lines.push(`Before writing a single line of code or plan, state:\n`);
+  lines.push(`\`\`\`\n1. WHAT DOMAIN?   → Frontend / Backend / Architecture / Full-Stack / DevOps\n2. WHAT PHASE?    → Define / Plan / Build / Verify / Review / Ship\n3. WHAT ROLE?     → Declare specialist role for this phase\n\`\`\`\n\n`);
+  lines.push(`### Non-Negotiable Rules\n\n`);
+  lines.push(`- **Zero-Assumption Investigation**: Never guess file paths or signatures. Inspect before modifying.\n`);
+  lines.push(`- **Zero-Placeholder Production Code**: Never emit lazy stubs, \`// TODO\`, or partial code.\n`);
+  lines.push(`- **Mandatory Proof-of-Work Verification**: Always run tests and validators before claiming completion.\n`);
+  lines.push(`- **Surgical Blast Radius**: Modify only files strictly within scope.\n\n`);
+  lines.push(`---\n`);
+
+  // ── Skills ───────────────────────────────────────────────────────────────────
+  lines.push(`\n## Skills Library\n\n`);
+  lines.push(`ContextOS uses on-demand progressive disclosure. Read the relevant \`SKILL.md\` file only when your task matches the trigger.\n\n`);
+  lines.push(`### Skill Routing Table\n\n`);
+  lines.push(`| Trigger / Domain | Skill | Path |\n`);
+  lines.push(`| --- | --- | --- |\n`);
+
+  const skills = collectSkillDirectories();
+  for (const skill of skills) {
+    const skillName = path.basename(skill);
+    const yamlPath = path.join(skill, 'skill.yaml');
+    let tags = skillName;
+    if (fs.existsSync(yamlPath)) {
+      const yaml = fs.readFileSync(yamlPath, 'utf8');
+      const rawTags = extractYamlField(yaml, 'tags');
+      if (rawTags) tags = rawTags.replace(/[\[\]]/g, '');
+    }
+    const relPath = `.agents/core/skills/${skillName}/SKILL.md`;
+    lines.push(`| \`${tags}\` | **${skillName}** | \`${relPath}\` |\n`);
+  }
+  lines.push(`\n---\n`);
+
+  let count = 0;
+  for (const skill of skills) {
+    const section = buildSkillSection(skill);
+    if (section) {
+      lines.push(section);
+      count++;
+    }
+  }
+
+  // ── Write ────────────────────────────────────────────────────────────────────
+  fs.mkdirSync(path.dirname(OUTPUT_FILE), { recursive: true });
+  fs.writeFileSync(OUTPUT_FILE, lines.join(''));
+  console.log(`Generated .github/copilot-instructions.md (${count} skills) → ${OUTPUT_FILE}`);
+}
+
+module.exports = { run };

package/.agents/adapters/cursor/export.js

@@ -0,0 +1,210 @@
+const fs = require('fs');
+const path = require('path');
+const { AGENTS_MD_PATH, collectSkillDirectories, extractYamlField, stripFrontmatter, readMeaningfulMarkdown } = require('../shared.js');
+
+// Output paths
+const OUTPUT_FILE = path.join(process.cwd(), '.cursorrules');
+const CURSOR_RULES_DIR = path.join(process.cwd(), '.cursor', 'rules');
+
+/**
+ * Cursor adapter — export.js
+ *
+ * Generates:
+ *   1. Modern modular Cursor rules in `.cursor/rules/<skill>.mdc` with glob filters
+ *   2. Flat `.cursorrules` at project root for backwards compatibility
+ *
+ * Format spec: https://docs.cursor.com/context/rules-for-ai
+ */
+
+function getSkillGlobsAndFlags(skillName) {
+  const ALWAYS_APPLY_SKILLS = ['engineering-workflow', 'gstack-roles', 'ponytail-mindset'];
+  if (ALWAYS_APPLY_SKILLS.includes(skillName)) {
+    return { globs: '', alwaysApply: true };
+  }
+
+  const FRONTEND_SKILLS = [
+    'react', 'nextjs', 'typescript', 'ui-ux-pro', 'impeccable-design',
+    'ui-design', 'ux-design', 'web-accessibility', 'brutalist-design',
+    'minimalist-design', 'soft-design', 'redesign-audit', 'react-best-practices',
+  ];
+  if (FRONTEND_SKILLS.includes(skillName)) {
+    return { globs: '**/*.{ts,tsx,js,jsx,css,scss,html}', alwaysApply: false };
+  }
+
+  const BACKEND_SKILLS = ['system-design', 'node', 'nestjs', 'microservices', 'ddd'];
+  if (BACKEND_SKILLS.includes(skillName)) {
+    return { globs: '**/*.{ts,js,json,prisma,sql}', alwaysApply: false };
+  }
+
+  if (skillName === 'database') {
+    return { globs: '**/*.{prisma,sql,sqlite,db,drizzle.config.*}', alwaysApply: false };
+  }
+
+  if (skillName === 'docker') {
+    return { globs: '**/Dockerfile*,**/docker-compose*.{yml,yaml}', alwaysApply: false };
+  }
+
+  if (skillName === 'testing') {
+    return { globs: '**/*.{test,spec}.{ts,js,tsx,jsx},vitest.config.*,jest.config.*', alwaysApply: false };
+  }
+
+  if (skillName === 'state-management') {
+    return { globs: '**/*{store,state,slice,reducer,atom}*.{ts,js,tsx,jsx}', alwaysApply: false };
+  }
+
+  if (skillName === 'performance' || skillName === 'vercel-optimize') {
+    return { globs: '**/*.{ts,tsx,js,jsx,json}', alwaysApply: false };
+  }
+
+  if (skillName === 'fastapi') {
+    return { globs: '**/*.{py,requirements.txt,Pipfile,pyproject.toml}', alwaysApply: false };
+  }
+
+  return { globs: '', alwaysApply: false };
+}
+
+function buildSkillSection(skillDir) {
+  const skillName  = path.basename(skillDir);
+  const skillMdPath  = path.join(skillDir, 'SKILL.md');
+  const yamlPath   = path.join(skillDir, 'skill.yaml');
+
+  let title = skillName;
+  let description = '';
+  if (fs.existsSync(yamlPath)) {
+    const yaml = fs.readFileSync(yamlPath, 'utf8');
+    title = extractYamlField(yaml, 'name') || skillName;
+    description = extractYamlField(yaml, 'description') || '';
+  }
+
+  if (!fs.existsSync(skillMdPath)) {
+    return null;
+  }
+
+  const raw = fs.readFileSync(skillMdPath, 'utf8');
+  const body = stripFrontmatter(raw);
+
+  if (!description) {
+    const firstLine = body.split(/\r?\n/).map(l => l.trim()).find(l => l && !l.startsWith('#'));
+    description = firstLine || '';
+  }
+
+  const descLine = description ? `> ${description.replace(/\r?\n+/g, ' ').trim()}\n` : '';
+  return `\n## Skill: ${title}\n${descLine}*Rule file: \`.cursor/rules/${skillName}.mdc\` (load on demand)*\n`;
+}
+
+function generateCursorMdc(skillDir) {
+  const skillName = path.basename(skillDir);
+  const skillMdPath = path.join(skillDir, 'SKILL.md');
+  const yamlPath = path.join(skillDir, 'skill.yaml');
+
+  if (!fs.existsSync(skillMdPath)) return null;
+
+  let title = skillName;
+  let description = `ContextOS rules for ${skillName}`;
+  if (fs.existsSync(yamlPath)) {
+    const yaml = fs.readFileSync(yamlPath, 'utf8');
+    title = extractYamlField(yaml, 'name') || skillName;
+    const desc = extractYamlField(yaml, 'description');
+    if (desc) description = desc;
+  }
+
+  let raw = fs.readFileSync(skillMdPath, 'utf8');
+  const examples = readMeaningfulMarkdown(path.join(skillDir, 'EXAMPLES.md'));
+  if (examples) raw += '\n\n' + examples;
+
+  const troubleshooting = readMeaningfulMarkdown(path.join(skillDir, 'TROUBLESHOOTING.md'));
+  if (troubleshooting) raw += '\n\n' + troubleshooting;
+
+  const body = stripFrontmatter(raw);
+  const { globs, alwaysApply } = getSkillGlobsAndFlags(skillName);
+
+  const cleanDescription = description.replace(/\r?\n+/g, ' ').replace(/"/g, "'").trim();
+  const mdcContent = `---
+description: "${cleanDescription}"
+globs: ${globs ? `"${globs}"` : '""'}
+alwaysApply: ${alwaysApply}
+---
+
+# Skill: ${title}
+
+${body}
+`;
+
+  return { skillName, mdcContent };
+}
+
+function run() {
+  console.log('Starting Cursor adapter export...');
+
+  const sections = [];
+
+  // ── Header ──────────────────────────────────────────────────────────────────
+  sections.push(
+    `# ContextOS — AI Rules for Cursor\n` +
+    `# Auto-generated by: node .agents/ctx.js export cursor\n` +
+    `# Source: .agents/core/skills/  ·  Do not edit manually.\n\n` +
+    `> **Core law: Do not read everything. Read only what the current task requires.**\n\n` +
+    `Detailed rules are modularized in \`.cursor/rules/*.mdc\` with file-glob activation.\n` +
+    `Core orchestration is handled by \`.cursor/rules/00-project-rules.mdc\`.\n`
+  );
+
+  // Prepare .cursor/rules directory
+  fs.mkdirSync(CURSOR_RULES_DIR, { recursive: true });
+
+  let count = 0;
+  let mdcCount = 0;
+
+  // Write 00-project-rules.mdc
+  if (fs.existsSync(AGENTS_MD_PATH)) {
+    const agentsMd = fs.readFileSync(AGENTS_MD_PATH, 'utf8');
+    const projectMdc = `---
+description: "ContextOS core project rules and role orchestration"
+globs: ""
+alwaysApply: true
+---
+
+# ContextOS — Project Operating System Rules
+
+${agentsMd}
+`;
+    fs.writeFileSync(path.join(CURSOR_RULES_DIR, '00-project-rules.mdc'), projectMdc);
+    mdcCount++;
+  }
+
+  // ── Skills Index ─────────────────────────────────────────────────────────────
+  sections.push('\n---\n\n# Skills Index (Loaded On-Demand)\n\n' +
+    'The following specialist skills are configured as `.cursor/rules/<skill>.mdc`:\n');
+  const skills = collectSkillDirectories();
+  const activeMdcFiles = new Set(['00-project-rules.mdc']);
+
+  for (const skill of skills) {
+    const section = buildSkillSection(skill);
+    if (section) {
+      sections.push(section);
+      count++;
+    }
+
+    const mdc = generateCursorMdc(skill);
+    if (mdc) {
+      const mdcFileName = `${mdc.skillName}.mdc`;
+      activeMdcFiles.add(mdcFileName);
+      fs.writeFileSync(path.join(CURSOR_RULES_DIR, mdcFileName), mdc.mdcContent);
+      mdcCount++;
+    }
+  }
+
+  // Clean up stale .mdc rules from uninstalled skills/plugins
+  if (fs.existsSync(CURSOR_RULES_DIR)) {
+    for (const file of fs.readdirSync(CURSOR_RULES_DIR)) {
+      if (file.endsWith('.mdc') && !activeMdcFiles.has(file)) {
+        fs.unlinkSync(path.join(CURSOR_RULES_DIR, file));
+      }
+    }
+  }
+
+  fs.writeFileSync(OUTPUT_FILE, sections.join('\n'));
+  console.log(`Generated .cursorrules (${count} skills) → ${OUTPUT_FILE}`);
+  console.log(`Generated .cursor/rules/*.mdc (${mdcCount} rules) → ${CURSOR_RULES_DIR}`);
+}
+
+module.exports = { run };

package/.agents/adapters/gemini/export.js

@@ -0,0 +1,115 @@
+const fs = require('fs');
+const path = require('path');
+const { collectSkillDirectories, resetDirectory, readMeaningfulMarkdown, extractYamlField } = require('../shared.js');
+
+const GENERATED_SKILLS_PATH = path.join(__dirname, '..', '..', 'generated', 'gemini', 'skills');
+
+function generateGeminiSkill(skillDir) {
+  const skillName = path.basename(skillDir);
+  const yamlPath = path.join(skillDir, 'skill.yaml');
+  const existingSkillMdPath = path.join(skillDir, 'SKILL.md');
+  const outputDir = path.join(GENERATED_SKILLS_PATH, skillName);
+
+  if (!fs.existsSync(existingSkillMdPath) && !fs.existsSync(yamlPath)) {
+    console.log(`Skipping ${skillName} (no skill.yaml or SKILL.md)`);
+    return;
+  }
+
+  let name = skillName;
+  let description = null;
+
+  if (fs.existsSync(yamlPath)) {
+    const yamlText = fs.readFileSync(yamlPath, 'utf8');
+    name = extractYamlField(yamlText, 'name') || skillName;
+    description = extractYamlField(yamlText, 'description');
+    if (!description) {
+      const descRegex = new RegExp(`^description:\\s*>\\s*\\n\\s*([^\\n]+)`, 'm');
+      const descMatch = yamlText.match(descRegex);
+      if (descMatch) description = descMatch[1].trim();
+    }
+  }
+  description = description || `ContextOS skill for ${name}`;
+
+  // Find all .md files in the skill directory deterministically
+  const files = fs.readdirSync(skillDir).sort((a, b) => a.localeCompare(b, 'en', { sensitivity: 'base' }));
+  const mdFiles = files.filter(f => f.endsWith('.md'));
+
+  // Primary skill content first: SKILL.md is canonical; fallback to <skillName>.md
+  const primaryMd = mdFiles.includes('SKILL.md')
+    ? 'SKILL.md'
+    : (mdFiles.find(f => f === `${skillName}.md`) || mdFiles[0]);
+
+  let mergedContent = '';
+  if (primaryMd) {
+    let primaryText = fs.readFileSync(path.join(skillDir, primaryMd), 'utf8');
+    // Strip existing frontmatter from source so we don't double-nest
+    primaryText = primaryText.replace(/^---[\s\S]*?---\r?\n/, '');
+    mergedContent += primaryText;
+  }
+
+  // Partition supplemental markdown files for deterministic, logical ordering:
+  // 1. Specific topic / reference docs (e.g. accessibility.md), sorted alphabetically
+  // 2. EXAMPLES.md
+  // 3. TROUBLESHOOTING.md
+  const otherTopicFiles = mdFiles.filter(f => f !== primaryMd && f !== 'EXAMPLES.md' && f !== 'TROUBLESHOOTING.md');
+  const orderedExtras = [...otherTopicFiles];
+  if (mdFiles.includes('EXAMPLES.md') && primaryMd !== 'EXAMPLES.md') orderedExtras.push('EXAMPLES.md');
+  if (mdFiles.includes('TROUBLESHOOTING.md') && primaryMd !== 'TROUBLESHOOTING.md') orderedExtras.push('TROUBLESHOOTING.md');
+
+  for (const mdFile of orderedExtras) {
+    // Avoid re-appending content that was already inlined via Source comments in SKILL.md
+    if (mergedContent.includes(`<!-- Source: ${mdFile} -->`)) continue;
+    const extraContent = readMeaningfulMarkdown(path.join(skillDir, mdFile));
+    if (extraContent) {
+      mergedContent += `\n\n<!-- Source: ${mdFile} -->\n\n` + extraContent;
+    }
+  }
+
+  // Construct Gemini SKILL.md format (normalizing line endings to \n)
+  const outputContent = `---
+name: ${name}
+description: >
+  ${description}
+---
+${mergedContent.trimStart()}
+`.replace(/\r\n/g, '\n');
+
+  fs.mkdirSync(outputDir, { recursive: true });
+  fs.writeFileSync(path.join(outputDir, 'SKILL.md'), outputContent);
+
+  console.log(`Generated SKILL.md for ${skillName}`);
+}
+
+const ANTIGRAVITY_SKILLS_PATH = path.join(__dirname, '..', '..', 'skills');
+
+function copyFolderRecursiveSync(source, target) {
+  if (!fs.existsSync(target)) fs.mkdirSync(target, { recursive: true });
+  const files = fs.readdirSync(source).sort((a, b) => a.localeCompare(b, 'en', { sensitivity: 'base' }));
+  for (const file of files) {
+    const curSource = path.join(source, file);
+    const curTarget = path.join(target, file);
+    if (fs.statSync(curSource).isDirectory()) {
+      copyFolderRecursiveSync(curSource, curTarget);
+    } else {
+      fs.copyFileSync(curSource, curTarget);
+    }
+  }
+}
+
+function run() {
+  console.log('Starting Gemini adapter export...');
+  resetDirectory(GENERATED_SKILLS_PATH);
+  
+  const skills = collectSkillDirectories();
+  for (const skill of skills) {
+    generateGeminiSkill(skill);
+  }
+
+  // Also sync to .agents/skills for Antigravity IDE native discovery
+  resetDirectory(ANTIGRAVITY_SKILLS_PATH);
+  copyFolderRecursiveSync(GENERATED_SKILLS_PATH, ANTIGRAVITY_SKILLS_PATH);
+
+  console.log('Export complete. Skills are in generated/gemini/skills and .agents/skills');
+}
+
+module.exports = { run };

package/.agents/adapters/shared.js

@@ -0,0 +1,119 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const AGENTS_DIR = path.join(__dirname, '..');
+const CORE_SKILLS_PATH = path.join(AGENTS_DIR, 'core', 'skills');
+const AGENTS_MD_PATH = path.join(AGENTS_DIR, 'AGENTS.md');
+
+/**
+ * Return every skill available to an installed ContextOS instance.
+ * Plugins intentionally live outside `core/skills`, so adapters must use this
+ * helper rather than enumerate the core directory themselves.
+ */
+function collectSkillDirectories(overrideProfile = null) {
+  const plugins = require(path.join(AGENTS_DIR, 'plugins.js'));
+  let dirs = plugins.collectAllSkillDirs()
+    .filter(dir => fs.existsSync(dir) && fs.statSync(dir).isDirectory())
+    .sort((a, b) => path.basename(a).localeCompare(path.basename(b)));
+
+  let profile = overrideProfile;
+  if (!profile) {
+    try {
+      const profilesEngine = require(path.join(AGENTS_DIR, 'profiles.js'));
+      profile = profilesEngine.getActiveProfile();
+    } catch {
+      profile = null;
+    }
+  }
+
+  if (profile && Array.isArray(profile.exclude_skills) && profile.exclude_skills.length > 0) {
+    dirs = dirs.filter(dir => {
+      const skillName = path.basename(dir);
+      return !profile.exclude_skills.includes(skillName);
+    });
+  }
+
+  return dirs;
+}
+
+function resetDirectory(directory) {
+  fs.rmSync(directory, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
+  fs.mkdirSync(directory, { recursive: true });
+}
+
+function stripFrontmatter(content) {
+  return content.replace(/^---[\s\S]*?---\r?\n/, '').trimStart();
+}
+
+function extractYamlField(yamlText, field) {
+  const lines = yamlText.split(/\r?\n/);
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const match = line.match(new RegExp(`^${field}:\\s*(.*)$`));
+    if (match) {
+      let rest = match[1].trim();
+      if (rest === '>' || rest === '|' || rest === '>-' || rest === '|-' || rest === '') {
+        const blockLines = [];
+        let j = i + 1;
+        while (j < lines.length) {
+          const nextLine = lines[j];
+          if (nextLine.trim() === '') {
+            blockLines.push('');
+            j++;
+            continue;
+          }
+          if (/^(\s{2,}|\t)/.test(nextLine)) {
+            blockLines.push(nextLine.trim());
+            j++;
+          } else {
+            break;
+          }
+        }
+        if (blockLines.length > 0) {
+          const sep = rest.startsWith('|') ? '\n' : ' ';
+          return blockLines.filter(Boolean).join(sep).trim();
+        }
+      }
+      // Strip surrounding quotes if present
+      if ((rest.startsWith('"') && rest.endsWith('"')) || (rest.startsWith("'") && rest.endsWith("'"))) {
+        rest = rest.slice(1, -1);
+      }
+      return rest || null;
+    }
+  }
+  return null;
+}
+
+/**
+ * Reads a markdown file only if it exists and contains meaningful content
+ * (filters out generic placeholder stubs).
+ */
+function readMeaningfulMarkdown(filePath) {
+  if (!fs.existsSync(filePath)) return null;
+  const content = fs.readFileSync(filePath, 'utf8').trim();
+  if (!content) return null;
+  if (
+    content.length < 150 &&
+    (
+      content.includes('Add detailed code examples') ||
+      content.includes('Add common errors, anti-patterns')
+    )
+  ) {
+    return null;
+  }
+  return content;
+}
+
+module.exports = {
+  AGENTS_DIR,
+  AGENTS_MD_PATH,
+  CORE_SKILLS_PATH,
+  collectSkillDirectories,
+  extractYamlField,
+  readMeaningfulMarkdown,
+  resetDirectory,
+  stripFrontmatter,
+};
+

package/.agents/adapters/zed/export.js

@@ -0,0 +1,111 @@
+const fs = require('fs');
+const path = require('path');
+const { AGENTS_MD_PATH, collectSkillDirectories, extractYamlField, stripFrontmatter, readMeaningfulMarkdown } = require('../shared.js');
+
+// Output destinations for Zed
+const ZED_DIR = path.join(process.cwd(), '.zed');
+const RULES_FILE = path.join(ZED_DIR, 'rules.md');
+const PROMPTS_DIR = path.join(ZED_DIR, 'prompts');
+
+/**
+ * Zed IDE adapter — export.js
+ *
+ * Generates:
+ *   1. `.zed/rules.md` — Project assistant instructions loaded into Zed's context
+ *   2. `.zed/prompts/*.md` — Modular slash-command prompts for Zed Assistant
+ *
+ * Format spec: https://zed.dev/docs/assistant
+ */
+
+function buildSkillSection(skillDir) {
+  const skillName  = path.basename(skillDir);
+  const skillMdPath  = path.join(skillDir, 'SKILL.md');
+  const yamlPath   = path.join(skillDir, 'skill.yaml');
+
+  let title = skillName;
+  let description = '';
+  if (fs.existsSync(yamlPath)) {
+    const yaml = fs.readFileSync(yamlPath, 'utf8');
+    title = extractYamlField(yaml, 'name') || skillName;
+    description = extractYamlField(yaml, 'description') || '';
+  }
+
+  if (!fs.existsSync(skillMdPath)) return null;
+
+  const raw = fs.readFileSync(skillMdPath, 'utf8');
+  const body = stripFrontmatter(raw);
+
+  if (!description) {
+    const firstLine = body.split(/\r?\n/).map(l => l.trim()).find(l => l && !l.startsWith('#'));
+    description = firstLine || '';
+  }
+
+  const descLine = description ? `> ${description.replace(/\r?\n+/g, ' ').trim()}\n` : '';
+  const promptRef = `*Prompt template: \`.zed/prompts/${skillName}.md\` (Use via /${skillName})*\n`;
+  return {
+    skillName,
+    title,
+    section: `\n### Skill: ${title}\n${descLine}${promptRef}`,
+    prompt: `# ContextOS — ${title}\n\n${descLine}\n${body}\n`,
+  };
+}
+
+function run() {
+  console.log('Starting Zed IDE adapter export...');
+
+  fs.mkdirSync(ZED_DIR, { recursive: true });
+  fs.mkdirSync(PROMPTS_DIR, { recursive: true });
+
+  const lines = [];
+
+  // ── Header ───────────────────────────────────────────────────────────────────
+  lines.push(
+    `# ContextOS — AI Rules for Zed Assistant\n`,
+    `<!-- Auto-generated by: node .agents/ctx.js export zed -->\n`,
+    `<!-- Source: .agents/core/skills/  ·  Do not edit manually. -->\n\n`
+  );
+
+  // ── Project Rules ────────────────────────────────────────────────────────────
+  if (fs.existsSync(AGENTS_MD_PATH)) {
+    const agentsMd = fs.readFileSync(AGENTS_MD_PATH, 'utf8');
+    lines.push(`## Project Rules (AGENTS.md)\n\n${agentsMd}\n\n---\n`);
+
+    // Also write a master prompt in .zed/prompts/contextos.md
+    fs.writeFileSync(path.join(PROMPTS_DIR, 'contextos.md'), `# ContextOS Master Prompt\n\n${agentsMd}\n`);
+  }
+
+  // ── Skills ───────────────────────────────────────────────────────────────────
+  lines.push(`\n## Skills Library\n`);
+  lines.push(`The following specialist skills guide architecture and implementation:\n`);
+
+  const skills = collectSkillDirectories();
+  const activePromptFiles = new Set(['contextos.md']);
+  let count = 0;
+
+  for (const skill of skills) {
+    const skillData = buildSkillSection(skill);
+    if (skillData) {
+      lines.push(skillData.section);
+      const promptFileName = `${skillData.skillName}.md`;
+      activePromptFiles.add(promptFileName);
+      fs.writeFileSync(path.join(PROMPTS_DIR, promptFileName), skillData.prompt);
+      count++;
+    }
+  }
+
+  // Clean up stale prompts from uninstalled skills/plugins
+  if (fs.existsSync(PROMPTS_DIR)) {
+    for (const file of fs.readdirSync(PROMPTS_DIR)) {
+      if (file.endsWith('.md') && !activePromptFiles.has(file)) {
+        fs.unlinkSync(path.join(PROMPTS_DIR, file));
+      }
+    }
+  }
+
+  // Write master .zed/rules.md
+  fs.writeFileSync(RULES_FILE, lines.join(''));
+  console.log(`Generated .zed/rules.md (${count} skills) → ${RULES_FILE}`);
+  console.log(`Generated .zed/prompts/*.md (${count} prompts) → ${PROMPTS_DIR}`);
+}
+
+module.exports = { run };