@soleri/forge 5.4.0 → 5.6.0

package/dist/templates/skills.js

@@ -0,0 +1,73 @@
+import { readFileSync, readdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const SKILLS_DIR = join(__dirname, '..', 'skills');
+/** Skills that use YOUR_AGENT_core placeholder and need agent-specific substitution. */
+const AGENT_SPECIFIC_SKILLS = new Set([
+    'brain-debrief',
+    'brainstorming',
+    'code-patrol',
+    'context-resume',
+    'executing-plans',
+    'fix-and-learn',
+    'health-check',
+    'knowledge-harvest',
+    'onboard-me',
+    'retrospective',
+    'second-opinion',
+    'systematic-debugging',
+    'test-driven-development',
+    'vault-capture',
+    'vault-navigator',
+    'verification-before-completion',
+    'writing-plans',
+]);
+/**
+ * Generate skill files for the scaffolded agent.
+ * Returns [relativePath, content] tuples for each skill.
+ *
+ * - Superpowers-adapted skills (MIT): copied as-is
+ * - Engine-adapted skills: YOUR_AGENT_core → {config.id}_core
+ */
+export function generateSkills(config) {
+    const files = [];
+    let skillFiles;
+    try {
+        skillFiles = readdirSync(SKILLS_DIR).filter((f) => f.endsWith('.md'));
+    }
+    catch {
+        return files;
+    }
+    for (const file of skillFiles) {
+        const skillName = file.replace('.md', '');
+        let content = readFileSync(join(SKILLS_DIR, file), 'utf-8');
+        if (AGENT_SPECIFIC_SKILLS.has(skillName)) {
+            content = content.replace(/YOUR_AGENT_core/g, `${config.id}_core`);
+        }
+        files.push([`skills/${skillName}/SKILL.md`, content]);
+    }
+    return files;
+}
+/**
+ * List all bundled skill names with their descriptions (from YAML frontmatter).
+ */
+export function listSkillDescriptions() {
+    let skillFiles;
+    try {
+        skillFiles = readdirSync(SKILLS_DIR).filter((f) => f.endsWith('.md'));
+    }
+    catch {
+        return [];
+    }
+    return skillFiles.map((file) => {
+        const content = readFileSync(join(SKILLS_DIR, file), 'utf-8');
+        const nameMatch = content.match(/^name:\s*(.+)$/m);
+        const descMatch = content.match(/^description:\s*"?(.+?)"?\s*$/m);
+        return {
+            name: nameMatch?.[1]?.trim() ?? file.replace('.md', ''),
+            description: descMatch?.[1]?.trim() ?? '',
+        };
+    });
+}
+//# sourceMappingURL=skills.js.map

package/dist/templates/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/templates/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAEnD,wFAAwF;AACxF,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,eAAe;IACf,eAAe;IACf,aAAa;IACb,gBAAgB;IAChB,iBAAiB;IACjB,eAAe;IACf,cAAc;IACd,mBAAmB;IACnB,YAAY;IACZ,eAAe;IACf,gBAAgB;IAChB,sBAAsB;IACtB,yBAAyB;IACzB,eAAe;IACf,iBAAiB;IACjB,gCAAgC;IAChC,eAAe;CAChB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,IAAI,UAAoB,CAAC;IAEzB,IAAI,CAAC;QACH,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAE5D,IAAI,qBAAqB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;QACrE,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,SAAS,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,IAAI,UAAoB,CAAC;IAEzB,IAAI,CAAC;QACH,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9D,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAClE,OAAO;YACL,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YACvD,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;SAC1C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/templates/test-facades.js

@@ -197,6 +197,8 @@ ${domainDescribes}
       expect(opNames).toContain('brain_feedback');
       expect(opNames).toContain('brain_feedback_stats');
       expect(opNames).toContain('brain_reset_extracted');
+      // Brain decay report (#89)
+      expect(opNames).toContain('brain_decay_report');
       // Agent-specific ops (5)
       expect(opNames).toContain('health');
       expect(opNames).toContain('identity');
@@ -227,7 +229,7 @@ ${domainDescribes}
       expect(opNames).toContain('governance_stats');
       expect(opNames).toContain('governance_expire');
       expect(opNames).toContain('governance_dashboard');
-      // Planning Extra ops (9)
+      // Planning Extra ops (13)
       expect(opNames).toContain('plan_iterate');
       expect(opNames).toContain('plan_split');
       expect(opNames).toContain('plan_reconcile');
@@ -237,6 +239,10 @@ ${domainDescribes}
       expect(opNames).toContain('plan_archive');
       expect(opNames).toContain('plan_list_tasks');
       expect(opNames).toContain('plan_stats');
+      expect(opNames).toContain('plan_execution_metrics');
+      expect(opNames).toContain('plan_record_task_metrics');
+      expect(opNames).toContain('plan_submit_deliverable');
+      expect(opNames).toContain('plan_verify_deliverables');
       // Memory Extra ops (8)
       expect(opNames).toContain('memory_delete');
       expect(opNames).toContain('memory_stats');
@@ -259,6 +265,10 @@ ${domainDescribes}
       expect(opNames).toContain('vault_seed');
       expect(opNames).toContain('vault_backup');
       expect(opNames).toContain('vault_age_report');
+      // #89: Bi-temporal
+      expect(opNames).toContain('vault_set_temporal');
+      expect(opNames).toContain('vault_find_expiring');
+      expect(opNames).toContain('vault_find_expired');
       // Admin ops (8)
       expect(opNames).toContain('admin_health');
       expect(opNames).toContain('admin_tool_list');
@@ -268,7 +278,7 @@ ${domainDescribes}
       expect(opNames).toContain('admin_version');
       expect(opNames).toContain('admin_reset_cache');
       expect(opNames).toContain('admin_diagnostic');
-      // Loop ops (7)
+      // Loop ops (8)
       expect(opNames).toContain('loop_start');
       expect(opNames).toContain('loop_iterate');
       expect(opNames).toContain('loop_status');
@@ -276,6 +286,7 @@ ${domainDescribes}
       expect(opNames).toContain('loop_history');
       expect(opNames).toContain('loop_is_active');
       expect(opNames).toContain('loop_complete');
+      expect(opNames).toContain('loop_anomaly_check');
       // Orchestrate ops (5)
       expect(opNames).toContain('orchestrate_plan');
       expect(opNames).toContain('orchestrate_execute');
@@ -293,7 +304,7 @@ ${domainDescribes}
       expect(opNames).toContain('plan_latest_check');
       expect(opNames).toContain('plan_meets_grade');
       expect(opNames).toContain('plan_auto_improve');
-      // Admin Extra ops (10)
+      // Admin Extra ops (11)
       expect(opNames).toContain('admin_telemetry');
       expect(opNames).toContain('admin_telemetry_recent');
       expect(opNames).toContain('admin_telemetry_reset');
@@ -304,11 +315,14 @@ ${domainDescribes}
       expect(opNames).toContain('admin_env');
       expect(opNames).toContain('admin_gc');
       expect(opNames).toContain('admin_export_config');
-      // Curator Extra ops (4)
+      expect(opNames).toContain('admin_hot_reload');
+      // Curator Extra ops (4 + 1 hybrid)
       expect(opNames).toContain('curator_entry_history');
       expect(opNames).toContain('curator_record_snapshot');
       expect(opNames).toContain('curator_queue_stats');
       expect(opNames).toContain('curator_enrich');
+      // #36: Hybrid contradiction detection
+      expect(opNames).toContain('curator_hybrid_contradictions');
       // Project ops (12)
       expect(opNames).toContain('project_get');
       expect(opNames).toContain('project_list');
@@ -326,8 +340,23 @@ ${domainDescribes}
       expect(opNames).toContain('memory_promote_to_global');
       expect(opNames).toContain('memory_configure');
       expect(opNames).toContain('memory_cross_project_search');
-      // Total: 152 (147 core + 5 agent-specific)
-      expect(facade.ops.length).toBe(152);
+      // Playbook ops (5)
+      expect(opNames).toContain('playbook_list');
+      expect(opNames).toContain('playbook_get');
+      expect(opNames).toContain('playbook_create');
+      expect(opNames).toContain('playbook_match');
+      expect(opNames).toContain('playbook_seed');
+      // Cognee Sync ops (3)
+      expect(opNames).toContain('cognee_sync_status');
+      expect(opNames).toContain('cognee_sync_drain');
+      expect(opNames).toContain('cognee_sync_reconcile');
+      // Intake ops (4)
+      expect(opNames).toContain('intake_ingest_book');
+      expect(opNames).toContain('intake_process');
+      expect(opNames).toContain('intake_status');
+      expect(opNames).toContain('intake_preview');
+      // Total: 208 (203 core + 5 agent-specific)
+      expect(facade.ops.length).toBe(208);
     });
 
     it('search should query across all domains with ranked results', async () => {

package/dist/templates/test-facades.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-facades.js","sourceRoot":"","sources":["../../src/templates/test-facades.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO;SACnC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,sBAAsB,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;SAChD,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmCS,MAAM,CAAC,EAAE;;;;;;;;;;;EAWzB,eAAe;;cAEH,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCA6Fe,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;iBAgBhC,MAAM,CAAC,EAAE;;;;;;;;kCAQQ,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDAoKM,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAmCvB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;mCACzB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;0CAWlB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;qCA0B9B,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;wCAgBN,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2EhE,CAAC;AACF,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAe,EAAE,MAAc;IAC7D,MAAM,UAAU,GAAG,GAAG,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;IAE7D,OAAO,eAAe,UAAU;;4CAEU,OAAO,OAAO,MAAM;;;;;kCAK9B,UAAU;;;;;;;;;iDASK,MAAM;;2BAE5B,MAAM,mBAAmB,MAAM;;;;;;kDAMR,MAAM;;;iCAGvB,MAAM;;2BAEZ,MAAM,kBAAkB,MAAM;;;;;;;wDAOD,MAAM;;;wCAGtB,MAAM;;;;eAI/B,MAAM;;;;;;;;yCAQoB,MAAM;;oCAEX,MAAM;;;;6CAIG,MAAM,mBAAmB,MAAM;;;gDAG5B,MAAM;gCACtB,MAAM;;;;6CAIO,MAAM,mBAAmB,MAAM;;;gDAG5B,MAAM;;kCAEpB,MAAM;;MAElC,CAAC;AACP,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACvD,CAAC"}
+{"version":3,"file":"test-facades.js","sourceRoot":"","sources":["../../src/templates/test-facades.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO;SACnC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,sBAAsB,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;SAChD,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmCS,MAAM,CAAC,EAAE;;;;;;;;;;;EAWzB,eAAe;;cAEH,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCA6Fe,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;iBAgBhC,MAAM,CAAC,EAAE;;;;;;;;kCAQQ,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDAiMM,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAmCvB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;mCACzB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;0CAWlB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;qCA0B9B,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;wCAgBN,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2EhE,CAAC;AACF,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAe,EAAE,MAAc;IAC7D,MAAM,UAAU,GAAG,GAAG,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;IAE7D,OAAO,eAAe,UAAU;;4CAEU,OAAO,OAAO,MAAM;;;;;kCAK9B,UAAU;;;;;;;;;iDASK,MAAM;;2BAE5B,MAAM,mBAAmB,MAAM;;;;;;kDAMR,MAAM;;;iCAGvB,MAAM;;2BAEZ,MAAM,kBAAkB,MAAM;;;;;;;wDAOD,MAAM;;;wCAGtB,MAAM;;;;eAI/B,MAAM;;;;;;;;yCAQoB,MAAM;;oCAEX,MAAM;;;;6CAIG,MAAM,mBAAmB,MAAM;;;gDAG5B,MAAM;gCACtB,MAAM;;;;6CAIO,MAAM,mBAAmB,MAAM;;;gDAG5B,MAAM;;kCAEpB,MAAM;;MAElC,CAAC;AACP,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACvD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soleri/forge",
-  "version": "5.4.0",
+  "version": "5.6.0",
   "description": "Scaffold AI agents that learn, remember, and grow with you.",
   "keywords": [
     "agent",
@@ -38,7 +38,7 @@
   },
   "scripts": {
     "dev": "tsx src/index.ts",
-    "build": "tsc",
+    "build": "tsc && cp -r src/skills dist/skills",
     "start": "node dist/index.js",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",

package/src/__tests__/scaffolder.test.ts

@@ -59,9 +59,9 @@ describe('Scaffolder', () => {
       expect(preview.facades).toHaveLength(4); // 3 domains + core
       expect(preview.facades[0].name).toBe('atlas_data_pipelines');
 
-      // Core facade should list all 152 ops (147 core + 5 agent-specific)
+      // Core facade should list all 208 ops (203 core + 5 agent-specific)
       const coreFacade = preview.facades.find((f) => f.name === 'atlas_core')!;
-      expect(coreFacade.ops.length).toBe(152);
+      expect(coreFacade.ops.length).toBe(208);
       expect(coreFacade.ops).toContain('curator_status');
       expect(coreFacade.ops).toContain('health');
 
@@ -248,6 +248,119 @@ describe('Scaffolder', () => {
     });
   });
 
+  describe('skills', () => {
+    it('should create skills directory with 10 SKILL.md files', () => {
+      scaffold(testConfig);
+      const skillsDir = join(tempDir, 'atlas', 'skills');
+
+      expect(existsSync(skillsDir)).toBe(true);
+
+      const skillDirs = readdirSync(skillsDir, { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .map((e) => e.name);
+
+      expect(skillDirs).toHaveLength(17);
+
+      // Verify each skill dir has a SKILL.md
+      for (const dir of skillDirs) {
+        expect(existsSync(join(skillsDir, dir, 'SKILL.md'))).toBe(true);
+      }
+    });
+
+    it('should include all expected skill names', () => {
+      scaffold(testConfig);
+      const skillsDir = join(tempDir, 'atlas', 'skills');
+      const skillDirs = readdirSync(skillsDir).sort();
+
+      expect(skillDirs).toEqual([
+        'brain-debrief',
+        'brainstorming',
+        'code-patrol',
+        'context-resume',
+        'executing-plans',
+        'fix-and-learn',
+        'health-check',
+        'knowledge-harvest',
+        'onboard-me',
+        'retrospective',
+        'second-opinion',
+        'systematic-debugging',
+        'test-driven-development',
+        'vault-capture',
+        'vault-navigator',
+        'verification-before-completion',
+        'writing-plans',
+      ]);
+    });
+
+    it('should have YAML frontmatter in all skills', () => {
+      scaffold(testConfig);
+      const skillsDir = join(tempDir, 'atlas', 'skills');
+      const skillDirs = readdirSync(skillsDir);
+
+      for (const dir of skillDirs) {
+        const content = readFileSync(join(skillsDir, dir, 'SKILL.md'), 'utf-8');
+        expect(content).toMatch(/^---\nname: /);
+        expect(content).toContain('description:');
+      }
+    });
+
+    it('should substitute YOUR_AGENT_core with agent ID in all skills', () => {
+      scaffold(testConfig);
+      const skillsDir = join(tempDir, 'atlas', 'skills');
+      const allSkills = readdirSync(skillsDir);
+
+      for (const name of allSkills) {
+        const content = readFileSync(join(skillsDir, name, 'SKILL.md'), 'utf-8');
+        expect(content).not.toContain('YOUR_AGENT_core');
+        // All skills that reference agent ops should have atlas_core
+        if (content.includes('_core')) {
+          expect(content).toContain('atlas_core');
+        }
+      }
+    });
+
+    it('should include MIT attribution in superpowers-adapted skills', () => {
+      scaffold(testConfig);
+      const skillsDir = join(tempDir, 'atlas', 'skills');
+      const superpowersSkills = [
+        'test-driven-development',
+        'systematic-debugging',
+        'verification-before-completion',
+        'brainstorming',
+        'writing-plans',
+        'executing-plans',
+      ];
+
+      for (const name of superpowersSkills) {
+        const content = readFileSync(join(skillsDir, name, 'SKILL.md'), 'utf-8');
+        expect(content).toContain('MIT License');
+      }
+    });
+
+    it('should have no YOUR_AGENT_core placeholder remaining in any skill', () => {
+      scaffold(testConfig);
+      const skillsDir = join(tempDir, 'atlas', 'skills');
+      const allSkills = readdirSync(skillsDir);
+
+      for (const name of allSkills) {
+        const content = readFileSync(join(skillsDir, name, 'SKILL.md'), 'utf-8');
+        expect(content).not.toContain('YOUR_AGENT_core');
+      }
+    });
+
+    it('should include skills in preview', () => {
+      const preview = previewScaffold(testConfig);
+      const paths = preview.files.map((f) => f.path);
+      expect(paths).toContain('skills/');
+    });
+
+    it('should mention skills in scaffold summary', () => {
+      const result = scaffold(testConfig);
+      expect(result.summary).toContain('built-in skills');
+    });
+  });
+
   describe('listAgents', () => {
     it('should list scaffolded agents', () => {
       scaffold(testConfig);

package/src/scaffolder.ts

@@ -6,7 +6,7 @@ import {
   readdirSync,
   readFileSync,
 } from 'node:fs';
-import { join } from 'node:path';
+import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
 import type { AgentConfig, ScaffoldResult, ScaffoldPreview, AgentInfo } from './types.js';
 
@@ -21,6 +21,7 @@ import { generateInjectClaudeMd } from './templates/inject-claude-md.js';
 import { generateActivate } from './templates/activate.js';
 import { generateReadme } from './templates/readme.js';
 import { generateSetupScript } from './templates/setup-script.js';
+import { generateSkills } from './templates/skills.js';
 
 /**
  * Preview what scaffold will create without writing anything.
@@ -75,6 +76,11 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
       path: 'scripts/setup.sh',
       description: 'Automated setup — Node.js check, build, Claude Code MCP registration',
     },
+    {
+      path: 'skills/',
+      description:
+        '17 built-in skills — TDD, debugging, planning, vault, brain, code patrol, retrospective, onboarding',
+    },
   ];
 
   if (config.hookPacks?.length) {
@@ -92,7 +98,7 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
     {
       name: `${config.id}_core`,
       ops: [
-        // From createCoreOps() — 144 generic ops
+        // From createCoreOps() — 150 generic ops
         'search',
         'vault_stats',
         'list_all',
@@ -125,6 +131,8 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'brain_promote_proposals',
         'brain_lifecycle',
         'brain_reset_extracted',
+        // Brain decay report (#89) — 1
+        'brain_decay_report',
         // Cognee ops — 5
         'cognee_status',
         'cognee_search',
@@ -134,6 +142,9 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         // LLM ops — 2
         'llm_rotate',
         'llm_call',
+        // Prompt ops — 2
+        'render_prompt',
+        'list_templates',
         'curator_status',
         'curator_detect_duplicates',
         'curator_contradictions',
@@ -156,7 +167,7 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'governance_stats',
         'governance_expire',
         'governance_dashboard',
-        // Planning Extra ops — 9
+        // Planning Extra ops — 22
         'plan_iterate',
         'plan_split',
         'plan_reconcile',
@@ -166,6 +177,25 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'plan_archive',
         'plan_list_tasks',
         'plan_stats',
+        // Planning evidence (#148)
+        'plan_submit_evidence',
+        'plan_verify_task',
+        'plan_verify_plan',
+        // Subagent dispatch (#149)
+        'plan_review_spec',
+        'plan_review_quality',
+        'plan_review_outcome',
+        // Brainstorm (#150)
+        'plan_brainstorm',
+        // Auto-reconcile (#151)
+        'plan_auto_reconcile',
+        // Validate plan (#152)
+        'plan_validate',
+        // Execution metrics + deliverables (#80, #83)
+        'plan_execution_metrics',
+        'plan_record_task_metrics',
+        'plan_submit_deliverable',
+        'plan_verify_deliverables',
         // Memory Extra ops — 8
         'memory_delete',
         'memory_stats',
@@ -188,6 +218,16 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'vault_seed',
         'vault_backup',
         'vault_age_report',
+        // Vault extra — seed canonical + knowledge lifecycle (5)
+        'vault_seed_canonical',
+        'knowledge_audit',
+        'knowledge_health',
+        'knowledge_merge',
+        'knowledge_reorganize',
+        // Bi-temporal vault ops (#89) — 3
+        'vault_set_temporal',
+        'vault_find_expiring',
+        'vault_find_expired',
         // Admin ops — 8
         'admin_health',
         'admin_tool_list',
@@ -197,14 +237,16 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'admin_version',
         'admin_reset_cache',
         'admin_diagnostic',
-        // Loop ops — 7
+        // Loop ops — 9
         'loop_start',
         'loop_iterate',
+        'loop_iterate_gate',
         'loop_status',
         'loop_cancel',
         'loop_history',
         'loop_is_active',
         'loop_complete',
+        'loop_anomaly_check',
         // Orchestrate ops — 5
         'orchestrate_plan',
         'orchestrate_execute',
@@ -222,7 +264,22 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'capture_quick',
         'search_intelligent',
         'search_feedback',
-        // Admin Extra ops — 10
+        // Enriched capture (#154) — 1
+        'capture_enriched',
+        // Cognee graph (#156) — 3
+        'cognee_get_node',
+        'cognee_graph_stats',
+        'cognee_export_status',
+        // Cognee Sync ops — 3
+        'cognee_sync_status',
+        'cognee_sync_drain',
+        'cognee_sync_reconcile',
+        // Intake ops — 4
+        'intake_ingest_book',
+        'intake_process',
+        'intake_status',
+        'intake_preview',
+        // Admin Extra ops — 23
         'admin_telemetry',
         'admin_telemetry_recent',
         'admin_telemetry_reset',
@@ -233,11 +290,31 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'admin_env',
         'admin_gc',
         'admin_export_config',
-        // Curator Extra ops — 4
+        // Admin key pool (#157)
+        'admin_key_pool_status',
+        'admin_create_token',
+        'admin_revoke_token',
+        'admin_list_tokens',
+        // Admin accounts (#158)
+        'admin_add_account',
+        'admin_remove_account',
+        'admin_rotate_account',
+        'admin_list_accounts',
+        'admin_account_status',
+        // Admin plugins (#159)
+        'admin_list_plugins',
+        'admin_plugin_status',
+        // Admin instruction validation (#160)
+        'admin_validate_instructions',
+        // Hot reload (#63)
+        'admin_hot_reload',
+        // Curator Extra ops — 5
         'curator_entry_history',
         'curator_record_snapshot',
         'curator_queue_stats',
         'curator_enrich',
+        // Hybrid contradiction detection (#36) — 1
+        'curator_hybrid_contradictions',
         // Project ops — 12
         'project_get',
         'project_list',
@@ -255,6 +332,12 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'memory_promote_to_global',
         'memory_configure',
         'memory_cross_project_search',
+        // Playbook ops — 5
+        'playbook_list',
+        'playbook_get',
+        'playbook_create',
+        'playbook_match',
+        'playbook_seed',
         // Agent-specific ops — 5
         'health',
         'identity',
@@ -295,6 +378,7 @@ export function scaffold(config: AgentConfig): ScaffoldResult {
   const dirs = [
     '',
     'scripts',
+    'skills',
     'src',
     'src/intelligence',
     'src/intelligence/data',
@@ -358,6 +442,15 @@ export function scaffold(config: AgentConfig): ScaffoldResult {
     filesCreated.push(path);
   }
 
+  // Generate skill files
+  const skillFiles = generateSkills(config);
+  for (const [path, content] of skillFiles) {
+    const skillDir = join(agentDir, dirname(path));
+    mkdirSync(skillDir, { recursive: true });
+    writeFileSync(join(agentDir, path), content, 'utf-8');
+    filesCreated.push(path);
+  }
+
   const totalOps = config.domains.length * 5 + 61; // 5 per domain + 56 core (from createCoreOps) + 5 agent-specific
 
   // Register the agent as an MCP server in ~/.claude.json
@@ -370,6 +463,7 @@ export function scaffold(config: AgentConfig): ScaffoldResult {
     `Intelligence layer (Brain) — TF-IDF scoring, auto-tagging, duplicate detection`,
     `Activation system included — say "Hello, ${config.name}!" to activate`,
     `1 test suite — facades (vault, brain, planner, llm tests provided by @soleri/core)`,
+    `${skillFiles.length} built-in skills (TDD, debugging, planning, vault, brain debrief)`,
   ];
 
   if (config.hookPacks?.length) {