claudecode-omc 5.6.4 → 5.6.5

package/.local/skills/prompt-optimizer/SKILL.md

@@ -119,7 +119,25 @@ Many users run OMC, superpowers, or their own custom installs where the same
 capability lives under a **different skill name**. Recommending a phantom skill
 wastes the user's time.
 
-**Rule:** before listing a skill in Section 2 / Section 3, mentally check:
+**Preferred check (live index):** before listing a skill in Section 2 / Section 3,
+read the auto-generated catalog:
+
+```
+cat ~/.claude/skills/_index.md
+```
+
+This file is regenerated by `omc-manage setup` (or manually via
+`omc-manage skill index`) and contains one row per installed skill with its
+`name | description`. Grep it for keywords from the user's intent:
+
+```
+grep -i "test\|tdd\|verification" ~/.claude/skills/_index.md
+```
+
+If a recommended skill does **not** appear in `_index.md`, replace it with a
+matching installed skill or fall back to the alias table below.
+
+**Fallback rule (when index is missing or empty):** mentally check
 *"Is this skill likely installed locally?"* If unsure, follow the alias table
 or add a verification note.
 
@@ -145,9 +163,10 @@ referencing them in Section 3, write:
 
 > If you don't have `<skill-name>` installed, recommend the universal `coding-standards` skill instead, or use the conventions in the project's `CLAUDE.md`.
 
-**Discovery shortcut for the user:** if you suspect the skill catalog is sparse,
-suggest they run `/oh-my-claudecode:skill-stocktake` (OMC) or `ls ~/.claude/skills/`
-to enumerate what they actually have.
+**Discovery shortcut for the user:** if `_index.md` is missing entirely, suggest
+they run `omc-manage skill index --scope user` (or just `omc-manage setup`,
+which regenerates it as a side effect). For a quality audit, use
+`/oh-my-claudecode:skill-stocktake`.
 
 ### Phase 1: Intent Detection
 

package/bundled/manifest.json

@@ -1,5 +1,5 @@
 {
-  "bundledAt": "2026-05-13T02:21:48Z",
+  "bundledAt": "2026-05-13T02:46:15Z",
   "sources": {
     "anthropic-skills": { "artifacts": 2 },
     "ecc": { "artifacts": 131 },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudecode-omc",
-  "version": "5.6.4",
+  "version": "5.6.5",
   "description": "Claude Code harness — best-practice skills, agents, hooks, and configs from multiple sources",
   "bin": {
     "omc-manage": "bin/omc-manage.js"

package/src/cli/index.js

@@ -31,6 +31,7 @@ function showHelp() {
   console.log('            evaluate [name] — quality score (Anthropic-aligned)');
   console.log('            compare [--threshold N] — cross-source overlap analysis');
   console.log('            recommend [--apply] — preference recommendations');
+  console.log('            index [--scope user|project] — generate _index.md catalog');
   console.log('  help      Show this help');
   console.log('');
   console.log('Artifact types: skills, agents, hooks, commands, guidelines, claude-md, settings, hud');

package/src/cli/setup.js

@@ -505,6 +505,15 @@ async function setup(args, flags = {}) {
     if (result.conflicts > 0) {
       console.log(`    resolved ${result.conflicts} conflicts`);
     }
+
+    if (artifactType === 'skills' && !flags.dryRun) {
+      try {
+        const { buildAndWriteIndex } = require('./skill-index');
+        await buildAndWriteIndex(installTarget, { quiet: false });
+      } catch (err) {
+        console.log(`    warning: skill index generation failed: ${err.message}`);
+      }
+    }
   }
 
   if (!flags.dryRun && scope === 'user') {

package/src/cli/skill-index.js

@@ -0,0 +1,209 @@
+/* eslint-disable no-console */
+const fs = require('fs');
+const fsp = require('fs/promises');
+const path = require('path');
+const os = require('os');
+const { getProjectRoot } = require('../config/paths');
+
+const INDEX_FILENAME = '_index.md';
+const MAX_DESCRIPTION_CHARS = 280;
+
+/**
+ * Parse YAML frontmatter from a SKILL.md, returning { name, description }.
+ *
+ * Handles:
+ *  - `key: value` single-line
+ *  - `key: >-` or `key: |` folded/literal block scalars (collects indented
+ *    continuation lines, joined with spaces)
+ *  - quoted values: stripped of surrounding quotes
+ *
+ * Returns null if frontmatter is missing or name field is absent.
+ */
+function parseFrontmatter(skillFile) {
+  if (!fs.existsSync(skillFile)) return null;
+
+  const content = fs.readFileSync(skillFile, 'utf8');
+  const match = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!match) return null;
+
+  const lines = match[1].split('\n');
+  const meta = {};
+  let currentKey = null;
+  let blockMode = false; // when value is `>-` or `|`
+
+  for (const raw of lines) {
+    if (!raw.trim()) continue;
+
+    // top-level key: detect by leading non-whitespace + colon
+    const keyMatch = raw.match(/^([a-zA-Z_-][\w-]*)\s*:\s*(.*)$/);
+    const isIndented = /^\s/.test(raw);
+
+    if (keyMatch && !isIndented) {
+      currentKey = keyMatch[1];
+      const valueRaw = keyMatch[2].trim();
+      if (valueRaw === '>-' || valueRaw === '>' || valueRaw === '|' || valueRaw === '|-') {
+        meta[currentKey] = '';
+        blockMode = true;
+      } else {
+        meta[currentKey] = stripQuotes(valueRaw);
+        blockMode = false;
+      }
+    } else if (currentKey && (blockMode || isIndented)) {
+      // continuation line
+      const continued = raw.trim();
+      if (continued) {
+        meta[currentKey] = (meta[currentKey] ? meta[currentKey] + ' ' : '') + continued;
+      }
+    }
+  }
+
+  if (!meta.name) return null;
+  return meta;
+}
+
+function stripQuotes(s) {
+  if ((s.startsWith('"') && s.endsWith('"')) || (s.startsWith("'") && s.endsWith("'"))) {
+    return s.slice(1, -1);
+  }
+  return s;
+}
+
+function truncateDescription(desc) {
+  if (!desc) return '';
+  // Collapse whitespace
+  const flat = desc.replace(/\s+/g, ' ').trim();
+  if (flat.length <= MAX_DESCRIPTION_CHARS) return flat;
+  // Truncate at sentence boundary if possible
+  const truncated = flat.slice(0, MAX_DESCRIPTION_CHARS);
+  const lastPeriod = truncated.lastIndexOf('.');
+  if (lastPeriod > MAX_DESCRIPTION_CHARS * 0.6) {
+    return truncated.slice(0, lastPeriod + 1);
+  }
+  return truncated + '…';
+}
+
+function escapeTableCell(s) {
+  return (s || '').replace(/\|/g, '\\|').replace(/\n/g, ' ');
+}
+
+/**
+ * Scan a directory of skills (each subdir contains SKILL.md) and return
+ * sorted list of { name, description }.
+ */
+function buildEntries(skillsDir) {
+  if (!fs.existsSync(skillsDir)) return [];
+
+  const entries = fs.readdirSync(skillsDir, { withFileTypes: true });
+  const items = [];
+
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    if (entry.name.startsWith('_') || entry.name.startsWith('.')) continue;
+
+    const skillFile = path.join(skillsDir, entry.name, 'SKILL.md');
+    const meta = parseFrontmatter(skillFile);
+    if (!meta) {
+      process.stderr.write(`  skipped: ${entry.name} (no frontmatter)\n`);
+      continue;
+    }
+    items.push({
+      name: meta.name,
+      description: truncateDescription(meta.description),
+    });
+  }
+
+  items.sort((a, b) => a.name.localeCompare(b.name));
+  return items;
+}
+
+/**
+ * Render entries as a Markdown table with a header preamble.
+ */
+function renderIndex(skillsDir, entries) {
+  const lines = [];
+  lines.push('# Skill Index');
+  lines.push('');
+  lines.push(`Auto-generated by \`omc-manage skill index\`. Do not edit by hand —`);
+  lines.push(`rerun \`omc-manage skill index\` after adding or removing skills.`);
+  lines.push('');
+  lines.push(`Source directory: \`${skillsDir.replace(os.homedir(), '~')}\``);
+  lines.push(`Generated: ${new Date().toISOString()}`);
+  lines.push(`Entries: ${entries.length}`);
+  lines.push('');
+  lines.push('## Usage for LLMs');
+  lines.push('');
+  lines.push('`grep -i "<keyword>" _index.md` to find skills matching an intent.');
+  lines.push('Each row is `name | description` — both fields searchable.');
+  lines.push('');
+  lines.push('| Skill | Description |');
+  lines.push('|---|---|');
+  for (const e of entries) {
+    lines.push(`| \`${escapeTableCell(e.name)}\` | ${escapeTableCell(e.description)} |`);
+  }
+  lines.push('');
+  return lines.join('\n');
+}
+
+/**
+ * Build and write the index. Returns { path, count }.
+ */
+async function buildAndWriteIndex(skillsDir, { quiet = false } = {}) {
+  const entries = buildEntries(skillsDir);
+  const indexPath = path.join(skillsDir, INDEX_FILENAME);
+  await fsp.writeFile(indexPath, renderIndex(skillsDir, entries), 'utf8');
+  if (!quiet) {
+    console.log(`  wrote ${indexPath.replace(os.homedir(), '~')} (${entries.length} entries)`);
+  }
+  return { path: indexPath, count: entries.length };
+}
+
+/**
+ * Resolve the skills install directory for the given scope.
+ */
+function resolveSkillsDir(scope) {
+  if (scope === 'project') {
+    const root = getProjectRoot();
+    return path.join(root, '.claude', 'skills');
+  }
+  // default: user scope
+  return path.join(os.homedir(), '.claude', 'skills');
+}
+
+/**
+ * CLI entrypoint: `omc-manage skill index [--scope user|project] [--quiet]`
+ */
+async function indexCommand(args, flags = {}) {
+  const scope = flags.scope || 'user';
+  if (scope !== 'user' && scope !== 'project') {
+    console.error(`Error: invalid --scope "${scope}" (expected user or project)`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const skillsDir = resolveSkillsDir(scope);
+  if (!fs.existsSync(skillsDir)) {
+    console.error(`Error: skills directory not found: ${skillsDir}`);
+    console.error('Run `omc-manage setup` first to install skills.');
+    process.exitCode = 1;
+    return;
+  }
+
+  console.log(`omc-manage skill index`);
+  console.log(`======================`);
+  console.log(`Scope: ${scope}`);
+  console.log(`Target: ${skillsDir.replace(os.homedir(), '~')}`);
+  console.log('');
+
+  const result = await buildAndWriteIndex(skillsDir, { quiet: flags.quiet });
+
+  console.log('');
+  console.log(`Indexed ${result.count} skills.`);
+}
+
+module.exports = {
+  indexCommand,
+  buildAndWriteIndex,
+  resolveSkillsDir,
+  parseFrontmatter, // exported for tests
+  truncateDescription, // exported for tests
+};

package/src/cli/skill.js

@@ -271,6 +271,10 @@ async function skill(args, flags = {}) {
   if (cmd === 'recommend') {
     return recommend(args, flags);
   }
+  if (cmd === 'index') {
+    const { indexCommand } = require('./skill-index');
+    return indexCommand(args.slice(1), flags);
+  }
 
   // Fall through to artifact subcommands (list, prefer, conflicts)
   flags.type = 'skills';