cognitive-core 0.2.2 → 0.2.4

package/dist/surfacing/skill-publisher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-publisher.d.ts","sourceRoot":"","sources":["../../src/surfacing/skill-publisher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGrE;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,GAAG,KAAK,CAmFhE;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,YAAY,CAA0B;gBAElC,OAAO,EAAE,cAAc;IAInC;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IAyBjE;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAQvE;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAuB/E;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;IACH,iBAAiB,IAAI,MAAM;CAG5B"}
+{"version":3,"file":"skill-publisher.d.ts","sourceRoot":"","sources":["../../src/surfacing/skill-publisher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AA2CrE;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,GAAG,KAAK,CA6GhE;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,YAAY,CAA0B;gBAElC,OAAO,EAAE,cAAc;IAInC;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IAyBjE;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAQvE;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAuB/E;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;IACH,iBAAiB,IAAI,MAAM;CAG5B"}

package/dist/surfacing/skill-publisher.js

@@ -6,6 +6,42 @@
  * conversion at the publish boundary.
  */
 import { getPlaybookSuccessRate } from '../types/playbook.js';
+/**
+ * Maximum length for the generated `description` field.
+ * Claude Code's skill format caps description at 1024 chars, so we truncate
+ * to stay safely within that boundary.
+ */
+const MAX_DESCRIPTION_LENGTH = 1024;
+/**
+ * Build the `description` field for a published Skill.
+ *
+ * The description is what lightweight trigger matchers — notably Claude Code's
+ * skill loader — key off to decide whether to load a skill. It needs two things:
+ *
+ * 1. A short "what it does" lead (pulled from the first situation, or the
+ *    strategy if no situation is set).
+ * 2. The concrete trigger phrases, surfaced inline so substring/keyword
+ *    matchers catch them. These live in `applicability.triggers` on the
+ *    playbook but are invisible to downstream consumers unless we lift them.
+ *
+ * Shape: `<lead>. Use when "<t1>", "<t2>", ..., "<tN>".`
+ */
+function buildDescription(playbook) {
+    let lead = playbook.applicability.situations[0]
+        ?? `${playbook.name}: ${playbook.guidance.strategy.slice(0, 100)}`;
+    // Ensure a sentence terminator before appending the trigger clause.
+    if (lead.length > 0 && !/[.!?]$/.test(lead)) {
+        lead += '.';
+    }
+    const triggers = playbook.applicability.triggers;
+    const triggerClause = triggers.length > 0
+        ? ` Use when ${triggers.map((t) => `"${t}"`).join(', ')}.`
+        : '';
+    const full = lead + triggerClause;
+    if (full.length <= MAX_DESCRIPTION_LENGTH)
+        return full;
+    return full.slice(0, MAX_DESCRIPTION_LENGTH - 3) + '...';
+}
 /**
  * Convert a Playbook to a Skill
  */
@@ -20,37 +56,52 @@ export function convertPlaybookToSkill(playbook) {
     if (playbook.guidance.steps?.length) {
         solution += '\n\nSteps:\n' + playbook.guidance.steps.map((s, i) => `${i + 1}. ${s}`).join('\n');
     }
-    // Build verification text
-    const verification = playbook.verification.successIndicators.length > 0
-        ? playbook.verification.successIndicators.join('. ')
-        : 'Verify the approach worked as expected.';
-    // Build notes from anti-patterns and refinements
-    const notesParts = [];
+    // Build description for semantic matching and lightweight trigger routing
+    const description = buildDescription(playbook);
+    // Build structured instructions body
+    const instructionParts = [];
+    // --- When to use / When not to use (Change A) ---
+    if (playbook.applicability.situations.length > 0) {
+        instructionParts.push('## When to use\n\n'
+            + playbook.applicability.situations.map((s) => `- ${s}`).join('\n'));
+    }
     if (playbook.applicability.antiPatterns.length > 0) {
-        notesParts.push('Do NOT use when: ' + playbook.applicability.antiPatterns.join('; '));
+        instructionParts.push('## When not to use\n\n'
+            + playbook.applicability.antiPatterns.map((a) => `- ${a}`).join('\n'));
     }
-    if (playbook.verification.failureIndicators.length > 0) {
-        notesParts.push('Watch for: ' + playbook.verification.failureIndicators.join('; '));
+    // --- Solution ---
+    instructionParts.push(`## Solution\n\n${solution}`);
+    // --- Verification with bulleted indicators (Change B) ---
+    const verificationParts = [];
+    if (playbook.verification.successIndicators.length > 0) {
+        verificationParts.push('Success:\n'
+            + playbook.verification.successIndicators.map((s) => `- ${s}`).join('\n'));
     }
-    if (playbook.evolution.refinements.length > 0) {
-        notesParts.push('Refinements:\n' + playbook.evolution.refinements.map(r => `- In ${r.context}: ${r.addition}`).join('\n'));
+    if (playbook.verification.failureIndicators.length > 0) {
+        verificationParts.push('Failure:\n'
+            + playbook.verification.failureIndicators.map((f) => `- ${f}`).join('\n'));
     }
     if (playbook.verification.rollbackStrategy) {
-        notesParts.push('Rollback: ' + playbook.verification.rollbackStrategy);
+        verificationParts.push(`Rollback: ${playbook.verification.rollbackStrategy}`);
+    }
+    if (verificationParts.length > 0) {
+        instructionParts.push(`## Verification\n\n${verificationParts.join('\n\n')}`);
+    }
+    else {
+        instructionParts.push('## Verification\n\nVerify the approach worked as expected.');
+    }
+    // --- Notes (refinements only — anti-patterns now in their own section) ---
+    const notesParts = [];
+    if (playbook.evolution.refinements.length > 0) {
+        notesParts.push('Refinements:\n'
+            + playbook.evolution.refinements.map((r) => `- In ${r.context}: ${r.addition}`).join('\n'));
     }
-    // Build description for semantic matching
-    const description = playbook.applicability.situations[0]
-        ?? `${playbook.name}: ${playbook.guidance.strategy.slice(0, 100)}`;
-    // Build instructions as structured markdown combining all content
-    const instructionParts = [];
-    instructionParts.push(`## Problem\n${playbook.applicability.situations.join('. ')}`);
-    instructionParts.push(`## Solution\n${solution}`);
-    instructionParts.push(`## Verification\n${verification}`);
     if (notesParts.length > 0) {
-        instructionParts.push(`## Notes\n${notesParts.join('\n\n')}`);
+        instructionParts.push(`## Notes\n\n${notesParts.join('\n\n')}`);
     }
+    // --- Example ---
     if (playbook.guidance.codeExample) {
-        instructionParts.push(`## Example\n\`\`\`\n${playbook.guidance.codeExample}\n\`\`\``);
+        instructionParts.push(`## Example\n\n\`\`\`\n${playbook.guidance.codeExample}\n\`\`\``);
     }
     const instructions = instructionParts.join('\n\n');
     // Estimate tokens (rough: 4 chars per token)
@@ -61,7 +112,7 @@ export function convertPlaybookToSkill(playbook) {
         version: playbook.evolution.version,
         description,
         instructions,
-        author: 'cognitive-core',
+        author: playbook.provenance?.curatedBy ?? 'cognitive-core',
         tags: playbook.applicability.domains,
         status: 'active',
         metrics: {

package/dist/surfacing/skill-publisher.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-publisher.js","sourceRoot":"","sources":["../../src/surfacing/skill-publisher.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skill-publisher.js","sourceRoot":"","sources":["../../src/surfacing/skill-publisher.ts"],"names":[],"mappings":"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"}

package/dist/types/playbook.d.ts

@@ -22,6 +22,17 @@ export interface Playbook {
     embedding?: number[];
     createdAt: Date;
     updatedAt: Date;
+    /**
+     * Whether end-users can invoke this skill directly (e.g. via /slash-command).
+     * Propagated into the published SKILL.md frontmatter as `user-invocable`.
+     */
+    userInvocable?: boolean;
+    /**
+     * Arbitrary key-value metadata propagated verbatim into the published
+     * SKILL.md frontmatter `metadata:` block. Use for ecosystem-specific
+     * fields (audience, component, ecosystem) without changing the core schema.
+     */
+    publishMetadata?: Record<string, unknown>;
 }
 /**
  * When to apply this playbook

package/dist/types/playbook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playbook.d.ts","sourceRoot":"","sources":["../../src/types/playbook.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"playbook.d.ts","sourceRoot":"","sources":["../../src/types/playbook.ts"],"names":[],"mappings":"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"}

package/dist/types/playbook.js

@@ -34,6 +34,8 @@ export function createPlaybook(input) {
         complexity: input.complexity ?? 'moderate',
         estimatedEffort: input.estimatedEffort ?? 3,
         embedding: input.embedding,
+        userInvocable: input.userInvocable,
+        publishMetadata: input.publishMetadata,
         createdAt: input.createdAt ?? now,
         updatedAt: input.updatedAt ?? now,
     };

package/dist/types/playbook.js.map

@@ -1 +1 @@
-{"version":3,"file":"playbook.js","sourceRoot":"","sources":["../../src/types/playbook.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwHH;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,KAIC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,YAAY,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;QAClF,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI;YAClC,iBAAiB,EAAE,EAAE;YACrB,iBAAiB,EAAE,EAAE;SACtB;QACD,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI;YAC5B,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,EAAE;YACf,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,EAAE;YACf,YAAY,EAAE,CAAC;YACf,YAAY,EAAE,CAAC;SAChB;QACD,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI;YAC9B,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE,GAAG;SAChB;QACD,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,GAAG,EAAE,4BAA4B;QACjE,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,UAAU;QAC1C,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,CAAC;QAC3C,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,GAAG;QACjC,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,GAAG;KAClC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAkB,EAClB,OAAoC,OAAO;IAE3C,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChF,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO;YACV,OAAO,GAAG,KAAK,GAAG,CAAC,MAAM,CAAC;QAC5B,KAAK,OAAO;YACV,OAAO,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC;QACnC,KAAK,OAAO,CAAC;QACb;YACE,OAAO,GAAG,KAAK,IAAI,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAkB;IACvD,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,YAAY,GAAG,QAAQ,CAAC,SAAS,CAAC,YAAY,CAAC;IAChF,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1B,OAAO,QAAQ,CAAC,SAAS,CAAC,YAAY,GAAG,KAAK,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAkB,EAAE,UAAkB,CAAC;IACtE,OAAO,QAAQ,CAAC,SAAS,CAAC,YAAY,GAAG,QAAQ,CAAC,SAAS,CAAC,YAAY,IAAI,OAAO,CAAC;AACtF,CAAC"}
+{"version":3,"file":"playbook.js","sourceRoot":"","sources":["../../src/types/playbook.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqIH;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,KAIC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,YAAY,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;QAClF,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI;YAClC,iBAAiB,EAAE,EAAE;YACrB,iBAAiB,EAAE,EAAE;SACtB;QACD,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI;YAC5B,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,EAAE;YACf,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,EAAE;YACf,YAAY,EAAE,CAAC;YACf,YAAY,EAAE,CAAC;SAChB;QACD,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI;YAC9B,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE,GAAG;SAChB;QACD,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,GAAG,EAAE,4BAA4B;QACjE,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,UAAU;QAC1C,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,CAAC;QAC3C,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,GAAG;QACjC,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,GAAG;KAClC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAkB,EAClB,OAAoC,OAAO;IAE3C,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChF,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO;YACV,OAAO,GAAG,KAAK,GAAG,CAAC,MAAM,CAAC;QAC5B,KAAK,OAAO;YACV,OAAO,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC;QACnC,KAAK,OAAO,CAAC;QACb;YACE,OAAO,GAAG,KAAK,IAAI,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAkB;IACvD,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,YAAY,GAAG,QAAQ,CAAC,SAAS,CAAC,YAAY,CAAC;IAChF,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1B,OAAO,QAAQ,CAAC,SAAS,CAAC,YAAY,GAAG,KAAK,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAkB,EAAE,UAAkB,CAAC;IACtE,OAAO,QAAQ,CAAC,SAAS,CAAC,YAAY,GAAG,QAAQ,CAAC,SAAS,CAAC,YAAY,IAAI,OAAO,CAAC;AACtF,CAAC"}

package/dist/workspace/templates/index.d.ts

@@ -11,4 +11,5 @@ export { teamPlaybookExtractionTemplate, type TeamPlaybookExtractionInput, type
 export { playbookEfficacyAuditTemplate, type PlaybookEfficacyAuditInput, type PlaybookEfficacyAuditOutput, type PlaybookRecommendation, } from './playbook-efficacy-audit.js';
 export { playbookDecayDetectionTemplate, type PlaybookDecayDetectionInput, type PlaybookDecayDetectionOutput, type DecaySignal, } from './playbook-decay-detection.js';
 export { playbookLifecycleReviewTemplate, type PlaybookLifecycleReviewInput, type PlaybookLifecycleReviewOutput, type LifecycleRecommendation, } from './playbook-lifecycle-review.js';
+export { skillEnrichmentTemplate, type SkillEnrichmentInput, type SkillEnrichmentOutput, } from './skill-enrichment.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/workspace/templates/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workspace/templates/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,0BAA0B,EAC1B,KAAK,uBAAuB,GAC7B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,0BAA0B,EAC1B,KAAK,uBAAuB,GAC7B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,sBAAsB,EACtB,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,sBAAsB,EACtB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,0BAA0B,EAC1B,KAAK,uBAAuB,GAC7B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,0BAA0B,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,cAAc,GACpB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,2BAA2B,EAC3B,KAAK,wBAAwB,GAC9B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,uBAAuB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,8BAA8B,EAC9B,KAAK,2BAA2B,GACjC,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,8BAA8B,EAC9B,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,6BAA6B,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,GAC5B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,8BAA8B,EAC9B,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,WAAW,GACjB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,+BAA+B,EAC/B,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,GAC7B,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workspace/templates/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,0BAA0B,EAC1B,KAAK,uBAAuB,GAC7B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,0BAA0B,EAC1B,KAAK,uBAAuB,GAC7B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,sBAAsB,EACtB,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,sBAAsB,EACtB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,0BAA0B,EAC1B,KAAK,uBAAuB,GAC7B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,0BAA0B,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,cAAc,GACpB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,2BAA2B,EAC3B,KAAK,wBAAwB,GAC9B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,uBAAuB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,8BAA8B,EAC9B,KAAK,2BAA2B,GACjC,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,8BAA8B,EAC9B,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,6BAA6B,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,GAC5B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,8BAA8B,EAC9B,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,WAAW,GACjB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,+BAA+B,EAC/B,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,GAC7B,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACL,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC"}

package/dist/workspace/templates/index.js

@@ -24,4 +24,6 @@ export { playbookEfficacyAuditTemplate, } from './playbook-efficacy-audit.js';
 export { playbookDecayDetectionTemplate, } from './playbook-decay-detection.js';
 // Playbook Lifecycle Review (meta-learning — portfolio health)
 export { playbookLifecycleReviewTemplate, } from './playbook-lifecycle-review.js';
+// Skill Enrichment (publish pipeline — agent-enriched SKILL.md generation)
+export { skillEnrichmentTemplate, } from './skill-enrichment.js';
 //# sourceMappingURL=index.js.map

package/dist/workspace/templates/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/workspace/templates/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,EACL,0BAA0B,GAE3B,MAAM,0BAA0B,CAAC;AAElC,sFAAsF;AACtF,OAAO,EACL,0BAA0B,GAE3B,MAAM,0BAA0B,CAAC;AAElC,6DAA6D;AAC7D,OAAO,EACL,sBAAsB,GAEvB,MAAM,sBAAsB,CAAC;AAE9B,qEAAqE;AACrE,OAAO,EACL,sBAAsB,GAGvB,MAAM,sBAAsB,CAAC;AAE9B,4DAA4D;AAC5D,OAAO,EACL,0BAA0B,GAE3B,MAAM,0BAA0B,CAAC;AAElC,0DAA0D;AAC1D,OAAO,EACL,0BAA0B,GAG3B,MAAM,0BAA0B,CAAC;AAElC,mDAAmD;AACnD,OAAO,EACL,2BAA2B,GAE5B,MAAM,2BAA2B,CAAC;AAEnC,wDAAwD;AACxD,OAAO,EACL,uBAAuB,GAExB,MAAM,uBAAuB,CAAC;AAE/B,2DAA2D;AAC3D,OAAO,EACL,8BAA8B,GAE/B,MAAM,+BAA+B,CAAC;AAEvC,2DAA2D;AAC3D,OAAO,EACL,8BAA8B,GAK/B,MAAM,+BAA+B,CAAC;AAEvC,6DAA6D;AAC7D,OAAO,EACL,6BAA6B,GAI9B,MAAM,8BAA8B,CAAC;AAEtC,qEAAqE;AACrE,OAAO,EACL,8BAA8B,GAI/B,MAAM,+BAA+B,CAAC;AAEvC,+DAA+D;AAC/D,OAAO,EACL,+BAA+B,GAIhC,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/workspace/templates/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,EACL,0BAA0B,GAE3B,MAAM,0BAA0B,CAAC;AAElC,sFAAsF;AACtF,OAAO,EACL,0BAA0B,GAE3B,MAAM,0BAA0B,CAAC;AAElC,6DAA6D;AAC7D,OAAO,EACL,sBAAsB,GAEvB,MAAM,sBAAsB,CAAC;AAE9B,qEAAqE;AACrE,OAAO,EACL,sBAAsB,GAGvB,MAAM,sBAAsB,CAAC;AAE9B,4DAA4D;AAC5D,OAAO,EACL,0BAA0B,GAE3B,MAAM,0BAA0B,CAAC;AAElC,0DAA0D;AAC1D,OAAO,EACL,0BAA0B,GAG3B,MAAM,0BAA0B,CAAC;AAElC,mDAAmD;AACnD,OAAO,EACL,2BAA2B,GAE5B,MAAM,2BAA2B,CAAC;AAEnC,wDAAwD;AACxD,OAAO,EACL,uBAAuB,GAExB,MAAM,uBAAuB,CAAC;AAE/B,2DAA2D;AAC3D,OAAO,EACL,8BAA8B,GAE/B,MAAM,+BAA+B,CAAC;AAEvC,2DAA2D;AAC3D,OAAO,EACL,8BAA8B,GAK/B,MAAM,+BAA+B,CAAC;AAEvC,6DAA6D;AAC7D,OAAO,EACL,6BAA6B,GAI9B,MAAM,8BAA8B,CAAC;AAEtC,qEAAqE;AACrE,OAAO,EACL,8BAA8B,GAI/B,MAAM,+BAA+B,CAAC;AAEvC,+DAA+D;AAC/D,OAAO,EACL,+BAA+B,GAIhC,MAAM,gCAAgC,CAAC;AAExC,2EAA2E;AAC3E,OAAO,EACL,uBAAuB,GAGxB,MAAM,uBAAuB,CAAC"}

package/dist/workspace/templates/skill-enrichment.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Skill Enrichment Template
+ *
+ * Agent-in-the-loop step between playbook extraction and skill publishing.
+ * Given a Playbook and its procedurally generated SKILL.md skeleton, an agent
+ * enriches the skill with narrative prose, worked examples, cross-references,
+ * and a trigger-rich description — things a procedural converter cannot produce.
+ *
+ * Complexity routing:
+ * - Simple playbooks (<=3 tactics, low complexity) → heuristic: keep procedural output as-is
+ * - Standard/complex playbooks → agent enrichment
+ */
+import type { Playbook } from '../../types/index.js';
+import type { AgenticTaskTemplate } from '../types.js';
+export interface SkillEnrichmentInput {
+    /** The playbook to enrich into a skill */
+    playbook: Playbook;
+    /** Optional: existing hand-written SKILL.md to use as style reference */
+    styleReference?: string;
+    /** Optional: related skill names for cross-referencing */
+    relatedSkills?: Array<{
+        name: string;
+        description: string;
+    }>;
+    /** Optional: domain context (e.g. "swarmkit ecosystem", "TypeScript tooling") */
+    domainContext?: string;
+}
+export interface SkillEnrichmentOutput {
+    /** Enriched SKILL.md frontmatter description (trigger-rich, under 1024 chars) */
+    description: string;
+    /** Enriched markdown body (replaces the procedural instructions) */
+    instructions: string;
+    /** Worked examples the agent generated */
+    examples: Array<{
+        title: string;
+        scenario: string;
+        steps: string;
+    }>;
+    /** Cross-references to related skills */
+    seeAlso: Array<{
+        name: string;
+        relation: string;
+    }>;
+    /** Agent's assessment of the playbook's completeness */
+    gaps: string[];
+}
+export declare const skillEnrichmentTemplate: AgenticTaskTemplate<SkillEnrichmentInput, SkillEnrichmentOutput>;
+//# sourceMappingURL=skill-enrichment.d.ts.map

package/dist/workspace/templates/skill-enrichment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-enrichment.d.ts","sourceRoot":"","sources":["../../../src/workspace/templates/skill-enrichment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,KAAK,EACV,mBAAmB,EAGpB,MAAM,aAAa,CAAC;AAOrB,MAAM,WAAW,oBAAoB;IACnC,0CAA0C;IAC1C,QAAQ,EAAE,QAAQ,CAAC;IACnB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,QAAQ,EAAE,KAAK,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,yCAAyC;IACzC,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,wDAAwD;IACxD,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAMD,eAAO,MAAM,uBAAuB,EAAE,mBAAmB,CACvD,oBAAoB,EACpB,qBAAqB,CAkNtB,CAAC"}

package/dist/workspace/templates/skill-enrichment.js

@@ -0,0 +1,175 @@
+/**
+ * Skill Enrichment Template
+ *
+ * Agent-in-the-loop step between playbook extraction and skill publishing.
+ * Given a Playbook and its procedurally generated SKILL.md skeleton, an agent
+ * enriches the skill with narrative prose, worked examples, cross-references,
+ * and a trigger-rich description — things a procedural converter cannot produce.
+ *
+ * Complexity routing:
+ * - Simple playbooks (<=3 tactics, low complexity) → heuristic: keep procedural output as-is
+ * - Standard/complex playbooks → agent enrichment
+ */
+import { convertPlaybookToSkill } from '../../surfacing/skill-publisher.js';
+// ============================================================
+// Template Implementation
+// ============================================================
+export const skillEnrichmentTemplate = {
+    taskType: 'skill-enrichment',
+    domain: 'skill-publishing',
+    description: 'Enrich a procedurally generated SKILL.md with narrative prose, examples, and cross-references',
+    assessComplexity(input) {
+        const pb = input.playbook;
+        const tacticCount = pb.guidance.tactics.length;
+        const hasSteps = (pb.guidance.steps?.length ?? 0) > 0;
+        const isComplex = pb.complexity === 'complex';
+        if (tacticCount <= 3 && !hasSteps && !isComplex)
+            return 'heuristic';
+        if (isComplex || tacticCount > 8)
+            return 'thorough';
+        return 'standard';
+    },
+    async heuristicFallback(input) {
+        const skill = convertPlaybookToSkill(input.playbook);
+        return {
+            description: skill.description,
+            instructions: skill.instructions,
+            examples: [],
+            seeAlso: (input.relatedSkills ?? []).map((r) => ({
+                name: r.name,
+                relation: `Related: ${r.description}`,
+            })),
+            gaps: [],
+        };
+    },
+    async prepareWorkspace(input, handle) {
+        // Write the playbook as structured JSON
+        await handle.writeJson('input', 'playbook.json', {
+            name: input.playbook.name,
+            applicability: input.playbook.applicability,
+            guidance: input.playbook.guidance,
+            verification: input.playbook.verification,
+            complexity: input.playbook.complexity,
+            confidence: input.playbook.confidence,
+            evolution: {
+                version: input.playbook.evolution.version,
+                successCount: input.playbook.evolution.successCount,
+                failureCount: input.playbook.evolution.failureCount,
+                refinements: input.playbook.evolution.refinements,
+            },
+            provenance: input.playbook.provenance,
+            userInvocable: input.playbook.userInvocable,
+            publishMetadata: input.playbook.publishMetadata,
+        });
+        // Write the procedural skeleton for the agent to improve upon
+        const skill = convertPlaybookToSkill(input.playbook);
+        await handle.writeRaw('input', 'skeleton.md', skill.instructions);
+        await handle.writeRaw('input', 'skeleton-description.txt', skill.description);
+        // Style reference (if provided)
+        if (input.styleReference) {
+            await handle.writeRaw('input', 'style-reference.md', input.styleReference);
+        }
+        // Related skills for cross-referencing
+        if (input.relatedSkills && input.relatedSkills.length > 0) {
+            await handle.writeJson('input', 'related-skills.json', input.relatedSkills);
+        }
+        // Domain context
+        if (input.domainContext) {
+            await handle.writeRaw('input', 'domain-context.txt', input.domainContext);
+        }
+    },
+    buildTaskPrompt(input) {
+        const parts = [
+            `Enrich the skill "${input.playbook.name}" into a high-quality SKILL.md that an AI agent will load and follow.`,
+            '',
+            '## Inputs',
+            '',
+            '- `input/playbook.json` — the structured playbook (applicability, guidance, verification)',
+            '- `input/skeleton.md` — procedurally generated markdown body (your starting point)',
+            '- `input/skeleton-description.txt` — procedurally generated frontmatter description',
+        ];
+        if (input.styleReference) {
+            parts.push('- `input/style-reference.md` — a hand-written SKILL.md to match in tone and structure');
+        }
+        if (input.relatedSkills && input.relatedSkills.length > 0) {
+            parts.push('- `input/related-skills.json` — related skills to cross-reference');
+        }
+        if (input.domainContext) {
+            parts.push('- `input/domain-context.txt` — domain context for accurate terminology');
+        }
+        parts.push('', '## What to produce', '', 'Read all inputs, then write `output/enrichment.json` with this schema:', '', '```json', '{', '  "description": "Trigger-rich frontmatter description, under 1024 chars. Structure: [What it does] + [Use when ...trigger phrases...]. Include concrete phrases users would say.",', '  "instructions": "Full markdown body. Must include:\\n- ## When to use (bulleted)\\n- ## When not to use (bulleted)\\n- ## Workflow (numbered tactics expanded into full prose — explain WHY each step matters, not just WHAT to do)\\n- ## Inputs / ## Outputs\\n- ## Verification (bulleted success/failure indicators)\\n- ## Edge cases (narrative, with recovery paths)\\n- ## Examples (2-3 worked scenarios with concrete commands)\\n- ## See also (cross-references)",', '  "examples": [{"title": "...", "scenario": "...", "steps": "..."}],', '  "seeAlso": [{"name": "skill-name", "relation": "why it is related"}],', '  "gaps": ["anything missing from the playbook that the skill should cover but cannot without more data"]', '}', '```', '', '## Guidelines', '', '- The skeleton is your starting point — improve it, do not discard it.', '- Expand each tactic in the Workflow section into a paragraph that explains the rationale, not just the command.', '- Generate 2-3 realistic examples with concrete tool calls (MCP tools, CLI commands, or library calls as appropriate for the domain).', '- Cross-reference related skills by name in the See Also section.', '- Flag gaps honestly — if the playbook is missing triggers, anti-patterns, or verification criteria, say so in the gaps array.', '- Keep the description under 1024 characters. It must include trigger phrases users would actually say.', '- Do not invent capabilities the playbook does not describe. Enrich what is there; do not fabricate.');
+        if (input.styleReference) {
+            parts.push('- Match the tone, section structure, and level of detail from the style reference.');
+        }
+        return parts.join('\n');
+    },
+    getSkills() { return []; },
+    getResources(input) {
+        const resources = [];
+        if (input.domainContext) {
+            resources.push({
+                type: 'file',
+                path: 'domain-context.txt',
+                source: input.domainContext,
+                description: 'Domain context for accurate terminology',
+            });
+        }
+        return resources;
+    },
+    outputConfig: {
+        files: [
+            {
+                path: 'enrichment.json',
+                format: 'json',
+                required: true,
+                description: 'Enriched skill content with description, instructions, examples, cross-refs, and gaps',
+            },
+        ],
+    },
+    async collectOutput(handle) {
+        const raw = await handle.readJson('output', 'enrichment.json');
+        return {
+            description: typeof raw.description === 'string'
+                ? raw.description.slice(0, 1024)
+                : '',
+            instructions: typeof raw.instructions === 'string'
+                ? raw.instructions
+                : '',
+            examples: Array.isArray(raw.examples)
+                ? raw.examples.map((e) => ({
+                    title: String(e.title ?? ''),
+                    scenario: String(e.scenario ?? ''),
+                    steps: String(e.steps ?? ''),
+                }))
+                : [],
+            seeAlso: Array.isArray(raw.seeAlso)
+                ? raw.seeAlso.map((s) => ({
+                    name: String(s.name ?? ''),
+                    relation: String(s.relation ?? ''),
+                }))
+                : [],
+            gaps: Array.isArray(raw.gaps)
+                ? raw.gaps.map(String)
+                : [],
+        };
+    },
+    async processOutput() {
+        // Caller handles merging the enriched output back into the Skill
+        // and publishing via SkillPublisher.
+    },
+    computeRequirements: {
+        mode: 'local',
+        complexity: 'standard',
+    },
+    getComputeRequirements(_input, complexity) {
+        return {
+            mode: 'local',
+            complexity,
+            timeout: complexity === 'thorough' ? 300_000 : 180_000,
+        };
+    },
+    agentType: 'claude-code',
+    timeout: 180_000,
+    captureToolCalls: true,
+};
+//# sourceMappingURL=skill-enrichment.js.map

package/dist/workspace/templates/skill-enrichment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-enrichment.js","sourceRoot":"","sources":["../../../src/workspace/templates/skill-enrichment.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cognitive-core",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "TypeScript-native cognitive core for adaptive learning and abstraction",
   "type": "module",
   "main": "dist/index.js",
@@ -65,16 +65,16 @@
   "author": "Alex Ngai",
   "license": "MIT",
   "devDependencies": {
-    "@types/better-sqlite3": "^7.6.8",
+    "@types/better-sqlite3": "^7.6.12",
     "@types/node": "^20.10.0",
     "eslint": "^8.55.0",
     "typescript": "^5.3.0",
     "vitest": "^1.0.0"
   },
   "dependencies": {
-    "acp-factory": "^0.1.7",
-    "agent-workspace": "^0.1.4",
-    "better-sqlite3": "^9.0.0",
+    "acp-factory": "^0.1.14",
+    "agent-workspace": "^0.1.5",
+    "better-sqlite3": "^12.0.0",
     "minimem": "^0.1.0",
     "sessionlog": "^0.0.4",
     "skill-tree": "^0.1.5",

package/src/surfacing/skill-publisher.ts

@@ -11,6 +11,46 @@ import type { Playbook } from '../types/index.js';
 import type { PublishResult, DeprecateResult } from './publisher.js';
 import { getPlaybookSuccessRate } from '../types/playbook.js';
 
+/**
+ * Maximum length for the generated `description` field.
+ * Claude Code's skill format caps description at 1024 chars, so we truncate
+ * to stay safely within that boundary.
+ */
+const MAX_DESCRIPTION_LENGTH = 1024;
+
+/**
+ * Build the `description` field for a published Skill.
+ *
+ * The description is what lightweight trigger matchers — notably Claude Code's
+ * skill loader — key off to decide whether to load a skill. It needs two things:
+ *
+ * 1. A short "what it does" lead (pulled from the first situation, or the
+ *    strategy if no situation is set).
+ * 2. The concrete trigger phrases, surfaced inline so substring/keyword
+ *    matchers catch them. These live in `applicability.triggers` on the
+ *    playbook but are invisible to downstream consumers unless we lift them.
+ *
+ * Shape: `<lead>. Use when "<t1>", "<t2>", ..., "<tN>".`
+ */
+function buildDescription(playbook: Playbook): string {
+  let lead = playbook.applicability.situations[0]
+    ?? `${playbook.name}: ${playbook.guidance.strategy.slice(0, 100)}`;
+
+  // Ensure a sentence terminator before appending the trigger clause.
+  if (lead.length > 0 && !/[.!?]$/.test(lead)) {
+    lead += '.';
+  }
+
+  const triggers = playbook.applicability.triggers;
+  const triggerClause = triggers.length > 0
+    ? ` Use when ${triggers.map((t) => `"${t}"`).join(', ')}.`
+    : '';
+
+  const full = lead + triggerClause;
+  if (full.length <= MAX_DESCRIPTION_LENGTH) return full;
+  return full.slice(0, MAX_DESCRIPTION_LENGTH - 3) + '...';
+}
+
 /**
  * Convert a Playbook to a Skill
  */
@@ -27,43 +67,69 @@ export function convertPlaybookToSkill(playbook: Playbook): Skill {
     solution += '\n\nSteps:\n' + playbook.guidance.steps.map((s, i) => `${i + 1}. ${s}`).join('\n');
   }
 
-  // Build verification text
-  const verification = playbook.verification.successIndicators.length > 0
-    ? playbook.verification.successIndicators.join('. ')
-    : 'Verify the approach worked as expected.';
+  // Build description for semantic matching and lightweight trigger routing
+  const description = buildDescription(playbook);
 
-  // Build notes from anti-patterns and refinements
-  const notesParts: string[] = [];
+  // Build structured instructions body
+  const instructionParts: string[] = [];
+
+  // --- When to use / When not to use (Change A) ---
+  if (playbook.applicability.situations.length > 0) {
+    instructionParts.push(
+      '## When to use\n\n'
+      + playbook.applicability.situations.map((s) => `- ${s}`).join('\n'),
+    );
+  }
   if (playbook.applicability.antiPatterns.length > 0) {
-    notesParts.push('Do NOT use when: ' + playbook.applicability.antiPatterns.join('; '));
+    instructionParts.push(
+      '## When not to use\n\n'
+      + playbook.applicability.antiPatterns.map((a) => `- ${a}`).join('\n'),
+    );
   }
-  if (playbook.verification.failureIndicators.length > 0) {
-    notesParts.push('Watch for: ' + playbook.verification.failureIndicators.join('; '));
+
+  // --- Solution ---
+  instructionParts.push(`## Solution\n\n${solution}`);
+
+  // --- Verification with bulleted indicators (Change B) ---
+  const verificationParts: string[] = [];
+  if (playbook.verification.successIndicators.length > 0) {
+    verificationParts.push(
+      'Success:\n'
+      + playbook.verification.successIndicators.map((s) => `- ${s}`).join('\n'),
+    );
   }
-  if (playbook.evolution.refinements.length > 0) {
-    notesParts.push('Refinements:\n' + playbook.evolution.refinements.map(
-      r => `- In ${r.context}: ${r.addition}`
-    ).join('\n'));
+  if (playbook.verification.failureIndicators.length > 0) {
+    verificationParts.push(
+      'Failure:\n'
+      + playbook.verification.failureIndicators.map((f) => `- ${f}`).join('\n'),
+    );
   }
   if (playbook.verification.rollbackStrategy) {
-    notesParts.push('Rollback: ' + playbook.verification.rollbackStrategy);
+    verificationParts.push(`Rollback: ${playbook.verification.rollbackStrategy}`);
+  }
+  if (verificationParts.length > 0) {
+    instructionParts.push(`## Verification\n\n${verificationParts.join('\n\n')}`);
+  } else {
+    instructionParts.push('## Verification\n\nVerify the approach worked as expected.');
   }
 
-  // Build description for semantic matching
-  const description = playbook.applicability.situations[0]
-    ?? `${playbook.name}: ${playbook.guidance.strategy.slice(0, 100)}`;
-
-  // Build instructions as structured markdown combining all content
-  const instructionParts: string[] = [];
-  instructionParts.push(`## Problem\n${playbook.applicability.situations.join('. ')}`);
-  instructionParts.push(`## Solution\n${solution}`);
-  instructionParts.push(`## Verification\n${verification}`);
+  // --- Notes (refinements only — anti-patterns now in their own section) ---
+  const notesParts: string[] = [];
+  if (playbook.evolution.refinements.length > 0) {
+    notesParts.push(
+      'Refinements:\n'
+      + playbook.evolution.refinements.map((r) => `- In ${r.context}: ${r.addition}`).join('\n'),
+    );
+  }
   if (notesParts.length > 0) {
-    instructionParts.push(`## Notes\n${notesParts.join('\n\n')}`);
+    instructionParts.push(`## Notes\n\n${notesParts.join('\n\n')}`);
   }
+
+  // --- Example ---
   if (playbook.guidance.codeExample) {
-    instructionParts.push(`## Example\n\`\`\`\n${playbook.guidance.codeExample}\n\`\`\``);
+    instructionParts.push(`## Example\n\n\`\`\`\n${playbook.guidance.codeExample}\n\`\`\``);
   }
+
   const instructions = instructionParts.join('\n\n');
 
   // Estimate tokens (rough: 4 chars per token)
@@ -75,7 +141,7 @@ export function convertPlaybookToSkill(playbook: Playbook): Skill {
     version: playbook.evolution.version,
     description,
     instructions,
-    author: 'cognitive-core',
+    author: playbook.provenance?.curatedBy ?? 'cognitive-core',
     tags: playbook.applicability.domains,
     status: 'active',
     metrics: {

package/src/types/playbook.ts

@@ -35,6 +35,19 @@ export interface Playbook {
   embedding?: number[]; // For semantic search
   createdAt: Date;
   updatedAt: Date;
+
+  // === PUBLISH HINTS (optional, used by SkillPublisher) ===
+  /**
+   * Whether end-users can invoke this skill directly (e.g. via /slash-command).
+   * Propagated into the published SKILL.md frontmatter as `user-invocable`.
+   */
+  userInvocable?: boolean;
+  /**
+   * Arbitrary key-value metadata propagated verbatim into the published
+   * SKILL.md frontmatter `metadata:` block. Use for ecosystem-specific
+   * fields (audience, component, ecosystem) without changing the core schema.
+   */
+  publishMetadata?: Record<string, unknown>;
 }
 
 /**
@@ -159,6 +172,8 @@ export function createPlaybook(
     complexity: input.complexity ?? 'moderate',
     estimatedEffort: input.estimatedEffort ?? 3,
     embedding: input.embedding,
+    userInvocable: input.userInvocable,
+    publishMetadata: input.publishMetadata,
     createdAt: input.createdAt ?? now,
     updatedAt: input.updatedAt ?? now,
   };

package/src/workspace/templates/index.ts

@@ -86,3 +86,10 @@ export {
   type PlaybookLifecycleReviewOutput,
   type LifecycleRecommendation,
 } from './playbook-lifecycle-review.js';
+
+// Skill Enrichment (publish pipeline — agent-enriched SKILL.md generation)
+export {
+  skillEnrichmentTemplate,
+  type SkillEnrichmentInput,
+  type SkillEnrichmentOutput,
+} from './skill-enrichment.js';

package/src/workspace/templates/skill-enrichment.ts

@@ -0,0 +1,275 @@
+/**
+ * Skill Enrichment Template
+ *
+ * Agent-in-the-loop step between playbook extraction and skill publishing.
+ * Given a Playbook and its procedurally generated SKILL.md skeleton, an agent
+ * enriches the skill with narrative prose, worked examples, cross-references,
+ * and a trigger-rich description — things a procedural converter cannot produce.
+ *
+ * Complexity routing:
+ * - Simple playbooks (<=3 tactics, low complexity) → heuristic: keep procedural output as-is
+ * - Standard/complex playbooks → agent enrichment
+ */
+
+import type { WorkspaceHandle } from 'agent-workspace';
+import type { Playbook } from '../../types/index.js';
+import { convertPlaybookToSkill } from '../../surfacing/skill-publisher.js';
+import type {
+  AgenticTaskTemplate,
+  AnalysisComplexity,
+  ResourceSpec,
+} from '../types.js';
+import type { ComputeRequirements } from '../../runtime/compute-provider.js';
+
+// ============================================================
+// Input / Output Types
+// ============================================================
+
+export interface SkillEnrichmentInput {
+  /** The playbook to enrich into a skill */
+  playbook: Playbook;
+  /** Optional: existing hand-written SKILL.md to use as style reference */
+  styleReference?: string;
+  /** Optional: related skill names for cross-referencing */
+  relatedSkills?: Array<{ name: string; description: string }>;
+  /** Optional: domain context (e.g. "swarmkit ecosystem", "TypeScript tooling") */
+  domainContext?: string;
+}
+
+export interface SkillEnrichmentOutput {
+  /** Enriched SKILL.md frontmatter description (trigger-rich, under 1024 chars) */
+  description: string;
+  /** Enriched markdown body (replaces the procedural instructions) */
+  instructions: string;
+  /** Worked examples the agent generated */
+  examples: Array<{
+    title: string;
+    scenario: string;
+    steps: string;
+  }>;
+  /** Cross-references to related skills */
+  seeAlso: Array<{
+    name: string;
+    relation: string;
+  }>;
+  /** Agent's assessment of the playbook's completeness */
+  gaps: string[];
+}
+
+// ============================================================
+// Template Implementation
+// ============================================================
+
+export const skillEnrichmentTemplate: AgenticTaskTemplate<
+  SkillEnrichmentInput,
+  SkillEnrichmentOutput
+> = {
+  taskType: 'skill-enrichment',
+  domain: 'skill-publishing',
+  description: 'Enrich a procedurally generated SKILL.md with narrative prose, examples, and cross-references',
+
+  assessComplexity(input: SkillEnrichmentInput): AnalysisComplexity {
+    const pb = input.playbook;
+    const tacticCount = pb.guidance.tactics.length;
+    const hasSteps = (pb.guidance.steps?.length ?? 0) > 0;
+    const isComplex = pb.complexity === 'complex';
+
+    if (tacticCount <= 3 && !hasSteps && !isComplex) return 'heuristic';
+    if (isComplex || tacticCount > 8) return 'thorough';
+    return 'standard';
+  },
+
+  async heuristicFallback(input: SkillEnrichmentInput): Promise<SkillEnrichmentOutput> {
+    const skill = convertPlaybookToSkill(input.playbook);
+    return {
+      description: skill.description,
+      instructions: skill.instructions,
+      examples: [],
+      seeAlso: (input.relatedSkills ?? []).map((r) => ({
+        name: r.name,
+        relation: `Related: ${r.description}`,
+      })),
+      gaps: [],
+    };
+  },
+
+  async prepareWorkspace(
+    input: SkillEnrichmentInput,
+    handle: WorkspaceHandle,
+  ): Promise<void> {
+    // Write the playbook as structured JSON
+    await handle.writeJson('input', 'playbook.json', {
+      name: input.playbook.name,
+      applicability: input.playbook.applicability,
+      guidance: input.playbook.guidance,
+      verification: input.playbook.verification,
+      complexity: input.playbook.complexity,
+      confidence: input.playbook.confidence,
+      evolution: {
+        version: input.playbook.evolution.version,
+        successCount: input.playbook.evolution.successCount,
+        failureCount: input.playbook.evolution.failureCount,
+        refinements: input.playbook.evolution.refinements,
+      },
+      provenance: input.playbook.provenance,
+      userInvocable: input.playbook.userInvocable,
+      publishMetadata: input.playbook.publishMetadata,
+    });
+
+    // Write the procedural skeleton for the agent to improve upon
+    const skill = convertPlaybookToSkill(input.playbook);
+    await handle.writeRaw('input', 'skeleton.md', skill.instructions);
+    await handle.writeRaw('input', 'skeleton-description.txt', skill.description);
+
+    // Style reference (if provided)
+    if (input.styleReference) {
+      await handle.writeRaw('input', 'style-reference.md', input.styleReference);
+    }
+
+    // Related skills for cross-referencing
+    if (input.relatedSkills && input.relatedSkills.length > 0) {
+      await handle.writeJson('input', 'related-skills.json', input.relatedSkills);
+    }
+
+    // Domain context
+    if (input.domainContext) {
+      await handle.writeRaw('input', 'domain-context.txt', input.domainContext);
+    }
+  },
+
+  buildTaskPrompt(input: SkillEnrichmentInput): string {
+    const parts: string[] = [
+      `Enrich the skill "${input.playbook.name}" into a high-quality SKILL.md that an AI agent will load and follow.`,
+      '',
+      '## Inputs',
+      '',
+      '- `input/playbook.json` — the structured playbook (applicability, guidance, verification)',
+      '- `input/skeleton.md` — procedurally generated markdown body (your starting point)',
+      '- `input/skeleton-description.txt` — procedurally generated frontmatter description',
+    ];
+
+    if (input.styleReference) {
+      parts.push('- `input/style-reference.md` — a hand-written SKILL.md to match in tone and structure');
+    }
+    if (input.relatedSkills && input.relatedSkills.length > 0) {
+      parts.push('- `input/related-skills.json` — related skills to cross-reference');
+    }
+    if (input.domainContext) {
+      parts.push('- `input/domain-context.txt` — domain context for accurate terminology');
+    }
+
+    parts.push(
+      '',
+      '## What to produce',
+      '',
+      'Read all inputs, then write `output/enrichment.json` with this schema:',
+      '',
+      '```json',
+      '{',
+      '  "description": "Trigger-rich frontmatter description, under 1024 chars. Structure: [What it does] + [Use when ...trigger phrases...]. Include concrete phrases users would say.",',
+      '  "instructions": "Full markdown body. Must include:\\n- ## When to use (bulleted)\\n- ## When not to use (bulleted)\\n- ## Workflow (numbered tactics expanded into full prose — explain WHY each step matters, not just WHAT to do)\\n- ## Inputs / ## Outputs\\n- ## Verification (bulleted success/failure indicators)\\n- ## Edge cases (narrative, with recovery paths)\\n- ## Examples (2-3 worked scenarios with concrete commands)\\n- ## See also (cross-references)",',
+      '  "examples": [{"title": "...", "scenario": "...", "steps": "..."}],',
+      '  "seeAlso": [{"name": "skill-name", "relation": "why it is related"}],',
+      '  "gaps": ["anything missing from the playbook that the skill should cover but cannot without more data"]',
+      '}',
+      '```',
+      '',
+      '## Guidelines',
+      '',
+      '- The skeleton is your starting point — improve it, do not discard it.',
+      '- Expand each tactic in the Workflow section into a paragraph that explains the rationale, not just the command.',
+      '- Generate 2-3 realistic examples with concrete tool calls (MCP tools, CLI commands, or library calls as appropriate for the domain).',
+      '- Cross-reference related skills by name in the See Also section.',
+      '- Flag gaps honestly — if the playbook is missing triggers, anti-patterns, or verification criteria, say so in the gaps array.',
+      '- Keep the description under 1024 characters. It must include trigger phrases users would actually say.',
+      '- Do not invent capabilities the playbook does not describe. Enrich what is there; do not fabricate.',
+    );
+
+    if (input.styleReference) {
+      parts.push(
+        '- Match the tone, section structure, and level of detail from the style reference.',
+      );
+    }
+
+    return parts.join('\n');
+  },
+
+  getSkills() { return []; },
+  getResources(input: SkillEnrichmentInput): ResourceSpec[] {
+    const resources: ResourceSpec[] = [];
+    if (input.domainContext) {
+      resources.push({
+        type: 'file',
+        path: 'domain-context.txt',
+        source: input.domainContext,
+        description: 'Domain context for accurate terminology',
+      });
+    }
+    return resources;
+  },
+
+  outputConfig: {
+    files: [
+      {
+        path: 'enrichment.json',
+        format: 'json' as const,
+        required: true,
+        description: 'Enriched skill content with description, instructions, examples, cross-refs, and gaps',
+      },
+    ],
+  },
+
+  async collectOutput(handle: WorkspaceHandle): Promise<SkillEnrichmentOutput> {
+    const raw = await handle.readJson('output', 'enrichment.json') as Record<string, unknown>;
+
+    return {
+      description: typeof raw.description === 'string'
+        ? raw.description.slice(0, 1024)
+        : '',
+      instructions: typeof raw.instructions === 'string'
+        ? raw.instructions
+        : '',
+      examples: Array.isArray(raw.examples)
+        ? (raw.examples as Array<Record<string, unknown>>).map((e) => ({
+          title: String(e.title ?? ''),
+          scenario: String(e.scenario ?? ''),
+          steps: String(e.steps ?? ''),
+        }))
+        : [],
+      seeAlso: Array.isArray(raw.seeAlso)
+        ? (raw.seeAlso as Array<Record<string, unknown>>).map((s) => ({
+          name: String(s.name ?? ''),
+          relation: String(s.relation ?? ''),
+        }))
+        : [],
+      gaps: Array.isArray(raw.gaps)
+        ? (raw.gaps as Array<unknown>).map(String)
+        : [],
+    };
+  },
+
+  async processOutput(): Promise<void> {
+    // Caller handles merging the enriched output back into the Skill
+    // and publishing via SkillPublisher.
+  },
+
+  computeRequirements: {
+    mode: 'local',
+    complexity: 'standard',
+  },
+
+  getComputeRequirements(
+    _input: SkillEnrichmentInput,
+    complexity: AnalysisComplexity,
+  ): ComputeRequirements {
+    return {
+      mode: 'local',
+      complexity,
+      timeout: complexity === 'thorough' ? 300_000 : 180_000,
+    };
+  },
+
+  agentType: 'claude-code',
+  timeout: 180_000,
+  captureToolCalls: true,
+};

package/tests/surfacing/skill-publisher.test.ts

@@ -77,10 +77,73 @@ describe('SkillPublisher', () => {
       const playbook = createSamplePlaybook();
       const skill = convertPlaybookToSkill(playbook);
 
-      expect(skill.description).toBe('TypeScript import fails with TS2307');
+      expect(skill.description).toContain('TypeScript import fails with TS2307');
       expect(skill.instructions).toContain('TypeScript import fails with TS2307');
     });
 
+    it('should surface trigger phrases inline in description for lightweight matching', () => {
+      const playbook = createSamplePlaybook();
+      const skill = convertPlaybookToSkill(playbook);
+
+      // Lead situation still present.
+      expect(skill.description).toContain('TypeScript import fails with TS2307');
+      // Explicit "Use when" clause listing each trigger phrase, quoted.
+      expect(skill.description).toContain('Use when');
+      expect(skill.description).toContain('"TS2307"');
+      expect(skill.description).toContain('"Cannot find module"');
+    });
+
+    it('should omit trigger clause when no triggers are declared', () => {
+      const playbook = createSamplePlaybook({
+        applicability: {
+          situations: ['Some situation'],
+          triggers: [],
+          antiPatterns: [],
+          domains: [],
+        },
+      });
+      const skill = convertPlaybookToSkill(playbook);
+
+      expect(skill.description).toBe('Some situation.');
+      expect(skill.description).not.toContain('Use when');
+    });
+
+    it('should cap description at 1024 chars', () => {
+      const playbook = createSamplePlaybook({
+        applicability: {
+          situations: ['X'.repeat(500)],
+          // Many long triggers would push past 1024 chars combined.
+          triggers: Array.from({ length: 20 }, (_, i) => 'trigger-phrase-' + 'y'.repeat(50) + `-${i}`),
+          antiPatterns: [],
+          domains: [],
+        },
+      });
+      const skill = convertPlaybookToSkill(playbook);
+
+      expect(skill.description.length).toBeLessThanOrEqual(1024);
+      expect(skill.description).toMatch(/\.\.\.$/);
+    });
+
+    it('should use provenance.curatedBy as author when set', () => {
+      const playbook = createSamplePlaybook({
+        provenance: {
+          origin: 'curated',
+          curatedBy: 'swarmkit-skills',
+          recordedAt: new Date(),
+        },
+      });
+      const skill = convertPlaybookToSkill(playbook);
+
+      expect(skill.author).toBe('swarmkit-skills');
+    });
+
+    it('should fall back to cognitive-core as author when provenance.curatedBy is absent', () => {
+      const playbook = createSamplePlaybook();
+      const skill = convertPlaybookToSkill(playbook);
+
+      expect(skill.author).toBe('cognitive-core');
+    });
+
     it('should build instructions from strategy, tactics, and steps', () => {
       const playbook = createSamplePlaybook();
       const skill = convertPlaybookToSkill(playbook);
@@ -92,15 +155,25 @@ describe('SkillPublisher', () => {
       expect(skill.instructions).toContain('Verify with tsc --noEmit');
     });
 
-    it('should include verification and notes in instructions', () => {
+    it('should include structured verification, when-to-use, and when-not-to-use sections', () => {
       const playbook = createSamplePlaybook();
       const skill = convertPlaybookToSkill(playbook);
 
-      expect(skill.instructions).toContain('Build passes');
-      expect(skill.instructions).toContain('Do NOT use when:');
-      expect(skill.instructions).toContain('Watch for:');
-      expect(skill.instructions).toContain('Refinements:');
+      // Verification indicators rendered as bulleted lists
+      expect(skill.instructions).toContain('Success:\n- Build passes');
+      expect(skill.instructions).toContain('Failure:\n- Same error persists');
       expect(skill.instructions).toContain('Rollback:');
+
+      // Anti-patterns now live in their own section, not in Notes
+      expect(skill.instructions).toContain('## When not to use');
+      expect(skill.instructions).toContain('- Module genuinely does not exist');
+
+      // Situations get their own section
+      expect(skill.instructions).toContain('## When to use');
+      expect(skill.instructions).toContain('- TypeScript import fails with TS2307');
+
+      // Refinements remain in Notes
+      expect(skill.instructions).toContain('Refinements:');
     });
 
     it('should compute metrics from evolution data', () => {
@@ -277,12 +350,12 @@ describe('SkillPublisher', () => {
       expect(result.error).toContain('not found');
     });
 
-    it('should preserve existing notes when deprecating', async () => {
+    it('should preserve existing content when deprecating', async () => {
       const publisher = new SkillPublisher(storage);
       await publisher.publishPlaybook(createSamplePlaybook({ id: 'notes-1' }));
 
       const before = await storage.getSkill('notes-1');
-      expect(before!.instructions).toContain('Do NOT use when:');
+      expect(before!.instructions).toContain('## When not to use');
 
       await publisher.deprecateSkill('notes-1', 'Superseded');