@lifeaitools/rdc-skills 0.24.25 → 0.24.26

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rdc",
-  "version": "0.24.25",
+  "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

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": "3adce37239675bd6c9d69b585053ff8bf3ee8137"
+  "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.25",
+  "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

@@ -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`);

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;
 }