@lifeaitools/rdc-skills 0.24.26 → 0.24.27

package/.claude-plugin/plugin.json

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

@@ -149,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

@@ -73,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": "5884908869da0ae91e3c004d9af344da71ae0079"
+  "sha": "d9537a89d4b7d9340e2cff34af5ea9934bcc5330"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifeaitools/rdc-skills",
-  "version": "0.24.26",
+  "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

@@ -122,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

@@ -211,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

@@ -29,6 +29,7 @@ for (const [name, text] of Object.entries(docs)) {
   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

@@ -201,6 +201,12 @@ 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: [] }; }