@lifeaitools/rdc-skills 0.24.25 → 0.24.27

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rdc",
-  "version": "0.24.25",
+  "version": "0.24.27",
   "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
@@ -143,6 +149,16 @@ curl -s -X POST https://rdc-skills.regendevcorp.com/mcp \
   -d '{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"rdc_skill_get","arguments":{"name":"rdc:build","variant":"cli"}}}'
 ```
 
+For direct API/curl clients that want metadata and rendered body in one parsed
+payload, add `format:"json"`:
+
+```bash
+curl -s -X POST https://rdc-skills.regendevcorp.com/mcp \
+  -H 'Content-Type: application/json' \
+  -H 'Accept: application/json, text/event-stream' \
+  -d '{"jsonrpc":"2.0","id":6,"method":"tools/call","params":{"name":"rdc_skill_get","arguments":{"name":"rdc:build","variant":"cli","format":"json"}}}'
+```
+
 Use `variant:"cli"` for Claude Code/Codex/local terminal instructions. Use
 `variant:"cloud"` for claude.ai web sessions where local daemon, shell, or
 filesystem steps need cloud-safe wording.

package/bin/rdc-skills-mcp.mjs

@@ -189,25 +189,48 @@ function buildMcpServer() {
     'rdc_skill_get',
     {
       description:
-        "Get a skill's SKILL.md body rendered for the caller. variant 'cli' returns the body unchanged; 'cloud' rewrites local-shell/clauth-daemon steps for the claude.ai web client. Omit variant to use auto-detection (defaults to cloud).",
+        "Get a skill's SKILL.md body rendered for the caller. variant 'cli' returns the body unchanged; 'cloud' rewrites local-shell/clauth-daemon steps for the claude.ai web client. Omit variant to use auto-detection (defaults to cloud). format 'json' returns metadata plus rendered body for direct API/curl callers.",
       inputSchema: {
         name: z.string().describe('Skill name or slash form (e.g. "deploy", "rdc:build", "rdc:brochurify", "lifeai-brochure-author"). See rdc_skill_list.'),
         variant: z.enum(['cli', 'cloud']).optional().describe('Force the rendered variant; overrides caller detection.'),
+        format: z.enum(['text', 'json']).optional().describe("Return 'text' (default) for agent-readable SKILL.md, or 'json' for metadata plus rendered body."),
       },
     },
-    async ({ name, variant }) => {
+    async ({ name, variant, format }) => {
       const resolvedName = resolveSkillName(name);
       if (!resolvedName) {
-        const valid = listSkills().map((s) => `${s.name} (${s.slash})`);
-        return textResult(
-          `Unknown skill '${name}'. Valid skills (${valid.length}): ${valid.join(', ')}`,
-        );
+        const valid = listSkills().map((s) => ({
+          name: s.name,
+          slash: s.slash,
+          aliases: s.aliases,
+          usage: s.usage,
+        }));
+        if (format === 'json') {
+          return textResult(JSON.stringify({
+            error: 'unknown_skill',
+            requested: name,
+            message: `Unknown skill '${name}'.`,
+            valid_count: valid.length,
+            valid,
+          }, null, 2));
+        }
+        return textResult(`Unknown skill '${name}'. Valid skills (${valid.length}): ${valid.map((s) => `${s.name} (${s.slash})`).join(', ')}`);
       }
       const resolved = variant || lastDetectedVariant || 'cloud';
       const rendered = renderSkill(resolvedName, resolved);
       if (!rendered) {
         return textResult(`Skill '${resolvedName}' exists in the catalog but has no SKILL.md body on disk.`);
       }
+      if (format === 'json') {
+        return textResult(JSON.stringify({
+          skill: getSkill(resolvedName),
+          requested: name,
+          resolved_name: resolvedName,
+          variant: resolved,
+          header: rendered.header,
+          body: rendered.body,
+        }, null, 2));
+      }
       return textResult(`${rendered.header}\n\n${rendered.body}`);
     },
   );

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:
@@ -72,6 +73,11 @@ curl -s -X POST https://rdc-skills.regendevcorp.com/mcp \
   -H 'Content-Type: application/json' \
   -H 'Accept: application/json, text/event-stream' \
   -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"rdc_skill_get","arguments":{"name":"rdc:build","variant":"cli"}}}'
+
+curl -s -X POST https://rdc-skills.regendevcorp.com/mcp \
+  -H 'Content-Type: application/json' \
+  -H 'Accept: application/json, text/event-stream' \
+  -d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"rdc_skill_get","arguments":{"name":"rdc:build","variant":"cli","format":"json"}}}'
 ```
 
 ## Hard Rules

package/git-sha.json

@@ -1,3 +1,3 @@
 {
-  "sha": "3adce37239675bd6c9d69b585053ff8bf3ee8137"
+  "sha": "d9537a89d4b7d9340e2cff34af5ea9934bcc5330"
 }

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.27",
   "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 \
@@ -121,6 +122,12 @@ RDC SKILLS — manifest: .claude-plugin/plugin.json @ v{version}
     -H 'Accept: application/json, text/event-stream' \
     -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"rdc_skill_get","arguments":{"name":"rdc:build","variant":"cli"}}}'
 
+  Fetch a structured skill payload:
+  curl -s -X POST https://rdc-skills.regendevcorp.com/mcp \
+    -H 'Content-Type: application/json' \
+    -H 'Accept: application/json, text/event-stream' \
+    -d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"rdc_skill_get","arguments":{"name":"rdc:build","variant":"cli","format":"json"}}}'
+
 ## Hard rules
 
 - `cf: yes` skills MUST consult CodeFlow before acting. Hooks fail-closed on unreachable CodeFlow for these.

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',
@@ -201,6 +211,21 @@ async function main() {
     check('rdc_skill_get returns tool text path', getText.length > 500, `length ${getText.length}`);
     check('rdc_skill_get accepts visible rdc:build alias', /rdc:build/i.test(getText));
 
+    const getJson = postMcp({
+      jsonrpc: '2.0',
+      id: 5,
+      method: 'tools/call',
+      params: {
+        name: 'rdc_skill_get',
+        arguments: { name: 'rdc:build', variant: 'cli', format: 'json' },
+      },
+    }, 'rdc_skill_get_json');
+    check('rdc_skill_get format=json curl exits 0', getJson.status === 0, getJson.stderr);
+    const getJsonBody = JSON.parse(resultText(latestEnvelope(getJson.stdout)));
+    check('rdc_skill_get format=json returns resolved name', getJsonBody.resolved_name === 'build');
+    check('rdc_skill_get format=json returns skill metadata', getJsonBody.skill?.slash === 'rdc:build' && getJsonBody.skill?.codeflow_required === true);
+    check('rdc_skill_get format=json returns rendered body', /rdc:build/i.test(getJsonBody.body || ''));
+
     const getMcp = curlWithStatus([
       '-s',
       `${TARGET}/mcp`,

package/tests/help-surface.test.mjs

@@ -26,6 +26,10 @@ 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, /"format":"json"/, `${name} must show structured rdc_skill_get format=json`);
   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',
@@ -186,10 +201,18 @@ async function sweep(url, label, { compareSource }) {
   const aliasBody = strip(callText(aliasGet.json));
   check(`${label}: rdc_skill_get accepts slash aliases`, /rdc:brochurify Orchestrator/.test(aliasBody));
 
+  const jsonGet = await mcp(url, { jsonrpc: '2.0', id: 23, method: 'tools/call', params: { name: 'rdc_skill_get', arguments: { name: 'rdc:build', variant: 'cli', format: 'json' } } });
+  let jsonBody; try { jsonBody = JSON.parse(callText(jsonGet.json)); } catch { jsonBody = {}; }
+  check(`${label}: rdc_skill_get format=json returns resolved name`, jsonBody.resolved_name === 'build');
+  check(`${label}: rdc_skill_get format=json returns metadata`, jsonBody.skill?.slash === 'rdc:build' && jsonBody.skill?.codeflow_required === true);
+  check(`${label}: rdc_skill_get format=json returns rendered body`, typeof jsonBody.body === 'string' && jsonBody.body.includes('rdc:build'));
+
   // search
   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;
 }