@lifeaitools/rdc-skills 0.24.24 → 0.24.26

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rdc",
-  "version": "0.24.24",
+  "version": "0.24.26",
   "description": "RDC typed-agent dispatch skill suite for Claude Code — plan, build, review, overnight unattended builds with work-item tracking and TDD enforcement.",
   "author": {
     "name": "LIFEAI",

package/README.md

@@ -124,6 +124,12 @@ curl -s -X POST https://rdc-skills.regendevcorp.com/mcp \
   -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"rdc_skill_list","arguments":{}}}'
 ```
 
+`rdc_skill_list` returns the full caller-facing catalog for each skill:
+`name`, `slash`, accepted `aliases`, `category`, `summary`, `when_to_use`,
+`usage`, `args`, `requires`, `produces`, `follows`, `leads_to`,
+`default_model`, `sandbox_aware`, `output_contract`, `enabled_default`,
+`codeflow_required`, and supported `variants` (`cli`, `cloud`).
+
 Search by natural-language intent:
 
 ```bash
@@ -286,31 +292,35 @@ Boundaries:
 
 ```
 skills/
+  brochure/SKILL.md    (print-quality PDF rendering)
   build/SKILL.md       (dispatch agents in waves — mandatory validator gate)
-  plan/SKILL.md        (create architecture + tasks)
-  preplan/SKILL.md     (research before planning)
-  review/SKILL.md      (quality gate: tests, types, docs)
-  overnight/SKILL.md   (unattended multi-epic supervisor)
-  fixit/SKILL.md       (quick-fix bypass)
-  status/SKILL.md      (project dashboard)
-  report/SKILL.md      (nightly report)
+  channel-formatter/SKILL.md (channel-native formatting and content packs)
+  co-develop/SKILL.md  (peer-aware Claude/Codex co-development)
   collab/SKILL.md      (bidirectional claude.ai ↔ Claude Code relay)
+  convert/SKILL.md     (Office/Markdown conversion)
+  deploy/SKILL.md      (Coolify ops: deploy, new, diagnose, audit)
+  design/SKILL.md      (RDC/Studio design, Palette Library, Rampa CLI)
+  fixit/SKILL.md       (quick-fix bypass)
+  fs-mcp/SKILL.md      (File System MCP bridge guidance)
   handoff/SKILL.md     (planning → work items)
+  help/SKILL.md        (manifest-driven skill index)
+  housekeeping/SKILL.md (weekly maintenance audit)
+  lifeai-brochure-author/SKILL.md (brochure JSX authoring)
+  overnight/SKILL.md   (unattended multi-epic supervisor)
+  plan/SKILL.md        (create architecture + tasks)
+  preplan/SKILL.md     (research before planning)
   prototype/SKILL.md   (build JSX prototype)
-  workitems/SKILL.md   (work item management)
-  design/SKILL.md      (RDC/Studio design, Palette Library, Rampa CLI)
-  help/SKILL.md        (skill index — shows current version)
-  deploy/SKILL.md      (Coolify ops: deploy, new, diagnose, audit)
-  release/SKILL.md     (atomic package/app release)
-  self-test/SKILL.md   (skill suite health check)
-  watch/SKILL.md       (session log watcher)
-  channel-formatter/SKILL.md (channel-native formatting and content packs)
-  convert/SKILL.md     (Office/Markdown conversion)
-  brochure/SKILL.md    (print-quality PDF rendering)
   rdc-brochurify/SKILL.md (Brochurify orchestration)
-  lifeai-brochure-author/SKILL.md (brochure JSX authoring)
   rdc-extract-verifier-rules/SKILL.md (verifier rule extraction)
+  release/SKILL.md     (atomic package/app release)
+  report/SKILL.md      (nightly report)
+  review/SKILL.md      (quality gate: tests, types, docs)
   rpms-filemap/SKILL.md (canonical RPMS file map)
+  self-test/SKILL.md   (skill suite health check)
+  status/SKILL.md      (project dashboard)
+  terminal-config/SKILL.md (Windows Terminal and hidden-launch policy)
+  watch/SKILL.md       (session log watcher)
+  workitems/SKILL.md   (work item management)
 
 guides/agents/         (agent-only playbooks — dispatched by rdc:build, not user-invocable)
   frontend.md          (React, UI, Tailwind)

package/commands/help.md

@@ -47,6 +47,7 @@ Header:       Accept: application/json, text/event-stream
 Tools:        rdc_skill_list, rdc_skill_search, rdc_skill_get
 Variants:     cli for Claude Code/Codex/local terminal; cloud for claude.ai
 Response:     SSE `data:` line contains the JSON-RPC envelope; tool text is result.content[0].text
+Catalog:      rdc_skill_list returns aliases, args, requires, produces, follows, leads_to, output_contract, codeflow_required, and variants
 ```
 
 Minimal curl examples:

package/git-sha.json

@@ -1,3 +1,3 @@
 {
-  "sha": "337ec305ad032632e314baec4d0d7ddcccca6b8c"
+  "sha": "5884908869da0ae91e3c004d9af344da71ae0079"
 }

package/lib/catalog.mjs

@@ -51,9 +51,12 @@ function toCatalogEntry(name, meta, frontmatter) {
   const metaTriggers = Array.isArray(meta.triggers) && meta.triggers.length ? meta.triggers : null;
   const fmTriggers = Array.isArray(fm.triggers) ? fm.triggers : [];
   const slash = meta.slash || fm.slash || `rdc:${name}`;
+  const aliases = [name, slash];
+  if (slash.startsWith('rdc:')) aliases.push(`/${slash}`);
   return {
     name,
     slash,
+    aliases,
     category: meta.category || fm.category || 'tooling',
     summary: description,
     when_to_use: metaTriggers || fmTriggers,
@@ -62,6 +65,18 @@ function toCatalogEntry(name, meta, frontmatter) {
     args: meta.args || fm.args || { positional: [], flags: [] },
     requires: Array.isArray(meta.requires) ? meta.requires
             : Array.isArray(fm.requires) ? fm.requires : [],
+    produces: Array.isArray(meta.produces) ? meta.produces
+             : Array.isArray(fm.produces) ? fm.produces : [],
+    follows: Array.isArray(meta.follows) ? meta.follows
+            : Array.isArray(fm.follows) ? fm.follows : [],
+    leads_to: Array.isArray(meta.leads_to) ? meta.leads_to
+              : Array.isArray(fm.leads_to) ? fm.leads_to : [],
+    default_model: meta.default_model || fm.default_model || 'inherit',
+    sandbox_aware: Boolean(meta.sandbox_aware ?? fm.sandbox_aware ?? false),
+    output_contract: meta.output_contract || fm.output_contract || null,
+    enabled_default: Boolean(meta.enabled_default ?? fm.enabled_default ?? true),
+    codeflow_required: Boolean(meta.codeflow_required ?? fm.codeflow_required ?? false),
+    variants: ['cli', 'cloud'],
   };
 }
 
@@ -179,7 +194,8 @@ export function getCloudOverride(name) {
 
 /**
  * Fuzzy/substring search over name + slash + summary + triggers.
- * Returns ranked [{ name, slash, summary, score }] (score: higher = better).
+ * Returns ranked rows with enough metadata for raw MCP/curl callers to choose
+ * and fetch a skill without a second catalog lookup. score: higher = better.
  */
 export function searchSkills(query) {
   const q = String(query || '').trim().toLowerCase();
@@ -201,7 +217,20 @@ export function searchSkills(query) {
       if (hay.triggers.includes(term)) score += 12;
       if (hay.summary.includes(term)) score += 6;
     }
-    if (score > 0) results.push({ name: s.name, slash: s.slash, summary: s.summary, score });
+    if (score > 0) {
+      results.push({
+        name: s.name,
+        slash: s.slash,
+        aliases: s.aliases,
+        category: s.category,
+        summary: s.summary,
+        usage: s.usage,
+        requires: s.requires,
+        codeflow_required: s.codeflow_required,
+        variants: s.variants,
+        score,
+      });
+    }
   }
   return results.sort((a, b) => b.score - a.score);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifeaitools/rdc-skills",
-  "version": "0.24.24",
+  "version": "0.24.26",
   "description": "RDC typed-agent dispatch skill suite for Claude Code - plan, build, review, overnight builds",
   "keywords": [
     "claude-code",

package/skills/help/SKILL.md

@@ -95,6 +95,7 @@ RDC SKILLS — manifest: .claude-plugin/plugin.json @ v{version}
   Tools:        rdc_skill_list, rdc_skill_search, rdc_skill_get
   Variants:     cli for Claude Code/Codex/local terminal; cloud for claude.ai
   Response:     SSE `data:` line contains the JSON-RPC envelope; tool text is result.content[0].text
+  Catalog:      rdc_skill_list returns aliases, args, requires, produces, follows, leads_to, output_contract, codeflow_required, and variants
 
   Extract the JSON-RPC envelope:
   curl -s -X POST https://rdc-skills.regendevcorp.com/mcp \

package/tests/curl-surface.test.mjs

@@ -170,6 +170,12 @@ async function main() {
     const listed = JSON.parse(resultText(latestEnvelope(list.stdout)));
     check('rdc_skill_list exposes 29 skills', listed.count === 29, `count ${listed.count}`);
     check('rdc_skill_list includes visible slash name', listed.skills.some((s) => s.slash === 'rdc:build'));
+    const buildRow = listed.skills.find((s) => s.name === 'build');
+    check('rdc_skill_list exposes aliases for slash callers', buildRow?.aliases?.includes('/rdc:build'));
+    check('rdc_skill_list exposes supported variants', JSON.stringify(buildRow?.variants) === JSON.stringify(['cli', 'cloud']));
+    check('rdc_skill_list exposes output contract metadata', typeof buildRow?.output_contract === 'string');
+    check('rdc_skill_list exposes CodeFlow requirement metadata', buildRow?.codeflow_required === true);
+    check('rdc_skill_list exposes side-effect metadata', Array.isArray(buildRow?.produces));
 
     const search = postMcp({
       jsonrpc: '2.0',
@@ -186,6 +192,10 @@ async function main() {
       'natural language search finds channel formatter',
       searchBody.results?.some((s) => s.name === 'channel-formatter' || s.slash === 'rdc:channel-formatter'),
     );
+    const formatterHit = searchBody.results?.find((s) => s.name === 'channel-formatter');
+    check('rdc_skill_search exposes usage metadata', /rdc:channel-formatter/.test(formatterHit?.usage || ''));
+    check('rdc_skill_search exposes category metadata', formatterHit?.category === 'tooling');
+    check('rdc_skill_search exposes variant metadata', formatterHit?.variants?.includes('cloud'));
 
     const get = postMcp({
       jsonrpc: '2.0',

package/tests/help-surface.test.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import assert from 'node:assert/strict';
-import { readFileSync } from 'node:fs';
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
@@ -26,6 +26,9 @@ for (const [name, text] of Object.entries(docs)) {
   assert.match(text, /rdc_skill_list/, `${name} must mention rdc_skill_list`);
   assert.match(text, /rdc_skill_search/, `${name} must mention rdc_skill_search`);
   assert.match(text, /rdc_skill_get/, `${name} must mention rdc_skill_get`);
+  assert.match(text, /output_contract/, `${name} must describe rdc_skill_list metadata fields`);
+  assert.match(text, /codeflow_required/, `${name} must describe CodeFlow metadata`);
+  assert.match(text, /variants/, `${name} must describe supported skill variants`);
   assert.match(text, /turn this article into social posts/, `${name} must include a natural-language search example`);
   assert.match(text, /"name":"rdc:build"/, `${name} must show rdc_skill_get accepts visible slash names`);
   assert.doesNotMatch(text, /https:\/\/rdc-skills\.dev\.regendevcorp\.com\/mcp/, `${name} must not point callers at dev MCP`);
@@ -43,4 +46,15 @@ assert.match(docs.commandHelp, /manifest-driven/i, 'command help should be manif
 assert.doesNotMatch(docs.commandHelp, /Print the full usage menu below verbatim/, 'command help must not use stale static menu wording');
 assert.doesNotMatch(docs.commandHelp, /get\/<service>/, 'command help must use current clauth /v/<service> wording');
 
+const skillDirs = readdirSync(join(root, 'skills'))
+  .filter((name) => {
+    const dir = join(root, 'skills', name);
+    return statSync(dir).isDirectory() && existsSync(join(dir, 'SKILL.md'));
+  })
+  .sort();
+const readmeSkillDirs = [...docs.readme.matchAll(/^\s{2}([A-Za-z0-9_-]+)\/SKILL\.md/gm)]
+  .map((match) => match[1])
+  .sort();
+assert.deepEqual(readmeSkillDirs, skillDirs, 'README File Structure must list every skill directory exactly once');
+
 console.log('help surface tests — PASS');

package/tests/mcp.test.mjs

@@ -89,6 +89,21 @@ function unitTests() {
   check('unit: catalog non-empty', cat.length >= 20, `got ${cat.length}`);
   check('unit: every entry has name+slash+category+summary field',
     cat.every((s) => s.name && s.slash && s.category && 'summary' in s));
+  check('unit: every entry exposes caller metadata fields',
+    cat.every((s) => Array.isArray(s.aliases)
+      && Array.isArray(s.produces)
+      && Array.isArray(s.follows)
+      && Array.isArray(s.leads_to)
+      && Array.isArray(s.variants)
+      && 'default_model' in s
+      && 'sandbox_aware' in s
+      && 'output_contract' in s
+      && 'enabled_default' in s
+      && 'codeflow_required' in s));
+  check('unit: every entry exposes cli/cloud variants',
+    cat.every((s) => JSON.stringify(s.variants) === JSON.stringify(['cli', 'cloud'])));
+  check('unit: every rdc slash entry includes leading slash alias',
+    cat.every((s) => !s.slash.startsWith('rdc:') || s.aliases.includes(`/${s.slash}`)));
   check('unit: every slash is explicit caller-facing shape',
     cat.every((s) => /^rdc:/.test(s.slash) || s.slash === s.name));
   check('unit: no synthesized duplicate rdc prefixes',
@@ -190,6 +205,8 @@ async function sweep(url, label, { compareSource }) {
   const se = await mcp(url, { jsonrpc: '2.0', id: 21, method: 'tools/call', params: { name: 'rdc_skill_search', arguments: { query: 'deploy' } } });
   let sr; try { sr = JSON.parse(callText(se.json)); } catch { sr = { results: [] }; }
   check(`${label}: search returns ranked results`, (sr.results || []).length > 0 && sr.results[0].name);
+  check(`${label}: search result includes caller metadata`,
+    Boolean(sr.results?.[0]?.usage && sr.results?.[0]?.category && Array.isArray(sr.results?.[0]?.variants)));
 
   return names.length;
 }