@lifeaitools/rdc-skills 0.24.17 → 0.24.19

package/.claude-plugin/plugin.json

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

@@ -90,6 +90,19 @@ curl -s -X POST https://rdc-skills.regendevcorp.com/mcp \
   -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'
 ```
 
+Responses come back as Server-Sent Events. For plain curl usage, extract the
+JSON-RPC envelope from the `data:` line:
+
+```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":2,"method":"tools/list"}' \
+  | sed -n 's/^data: //p'
+```
+
+Tool results put the human-readable payload in `result.content[0].text`.
+
 List tools:
 
 ```bash
@@ -117,13 +130,14 @@ curl -s -X POST https://rdc-skills.regendevcorp.com/mcp \
   -d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"rdc_skill_search","arguments":{"query":"turn this article into social posts"}}}'
 ```
 
-Fetch a skill body for a specific caller surface:
+Fetch a skill body for a specific caller surface. `name` accepts either the
+catalog `name` (`build`) or the visible slash form (`rdc:build`):
 
 ```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":5,"method":"tools/call","params":{"name":"rdc_skill_get","arguments":{"name":"build","variant":"cli"}}}'
+  -d '{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"rdc_skill_get","arguments":{"name":"rdc:build","variant":"cli"}}}'
 ```
 
 Use `variant:"cli"` for Claude Code/Codex/local terminal instructions. Use

package/bin/rdc-skills-mcp.mjs

@@ -46,7 +46,7 @@ import {
   getSkill,
   getSkillBody,
   getCloudOverride,
-  skillNames,
+  resolveSkillName,
   searchSkills,
 } from '../lib/catalog.mjs';
 import { toCloudBody } from '../lib/cloud-rewrite.mjs';
@@ -161,21 +161,22 @@ function buildMcpServer() {
       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).",
       inputSchema: {
-        name: z.string().describe('Skill name (e.g. "deploy", "build"). See rdc_skill_list.'),
+        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.'),
       },
     },
     async ({ name, variant }) => {
-      const valid = skillNames();
-      if (!valid.includes(name)) {
+      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 resolved = variant || lastDetectedVariant || 'cloud';
-      const rendered = renderSkill(name, resolved);
+      const rendered = renderSkill(resolvedName, resolved);
       if (!rendered) {
-        return textResult(`Skill '${name}' exists in the catalog but has no SKILL.md body on disk.`);
+        return textResult(`Skill '${resolvedName}' exists in the catalog but has no SKILL.md body on disk.`);
       }
       return textResult(`${rendered.header}\n\n${rendered.body}`);
     },

package/commands/help.md

@@ -46,11 +46,18 @@ Health:       curl -s https://rdc-skills.regendevcorp.com/health
 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
 ```
 
 Minimal curl examples:
 
 ```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":0,"method":"tools/list"}' \
+  | sed -n 's/^data: //p'
+
 curl -s -X POST https://rdc-skills.regendevcorp.com/mcp \
   -H 'Content-Type: application/json' \
   -H 'Accept: application/json, text/event-stream' \
@@ -64,7 +71,7 @@ curl -s -X POST https://rdc-skills.regendevcorp.com/mcp \
 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":"build","variant":"cli"}}}'
+  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"rdc_skill_get","arguments":{"name":"rdc:build","variant":"cli"}}}'
 ```
 
 ## Hard Rules

package/git-sha.json

@@ -1,3 +1,3 @@
 {
-  "sha": "f24f53db78dac2ce5a7f79d6815d8fb9ceb30c54"
+  "sha": "9c73b2cb3e0d6caedfd64996cc3ce587344d5859"
 }

package/lib/catalog.mjs

@@ -115,7 +115,8 @@ export function listSkills() {
 
 /** Full catalog row for one skill, or null if unknown. */
 export function getSkill(name) {
-  return getCatalog().find((s) => s.name === name) || null;
+  const resolved = resolveSkillName(name);
+  return resolved ? getCatalog().find((s) => s.name === resolved) || null : null;
 }
 
 /** List of valid skill names (for error messages). */
@@ -123,12 +124,35 @@ export function skillNames() {
   return getCatalog().map((s) => s.name);
 }
 
+/** Return the canonical skill directory name for a bare name, slash, or usage token. */
+export function resolveSkillName(input) {
+  const raw = String(input || '').trim();
+  if (!raw) return null;
+  const token = raw.split(/\s+/)[0];
+  const catalog = getCatalog();
+  const direct = catalog.find((s) => s.name === token || s.slash === token);
+  if (direct) return direct.name;
+  if (token.startsWith('/')) {
+    const withoutSlash = token.slice(1);
+    const slashMatch = catalog.find((s) => s.slash === withoutSlash);
+    if (slashMatch) return slashMatch.name;
+  }
+  if (token.startsWith('rdc:')) {
+    const bare = token.slice(4);
+    const bareMatch = catalog.find((s) => s.name === bare || s.name === `rdc-${bare}`);
+    if (bareMatch) return bareMatch.name;
+  }
+  return null;
+}
+
 /**
  * Read the raw SKILL.md body (frontmatter stripped) for a skill, live from disk.
  * Returns null if the file does not exist.
  */
 export function getSkillBody(name) {
-  const skillMd = path.join(SKILLS_DIR, name, 'SKILL.md');
+  const resolved = resolveSkillName(name);
+  if (!resolved) return null;
+  const skillMd = path.join(SKILLS_DIR, resolved, 'SKILL.md');
   if (!fs.existsSync(skillMd)) return null;
   const raw = fs.readFileSync(skillMd, 'utf8').replace(/\r\n/g, '\n');
   // Strip the leading frontmatter block if present.
@@ -138,7 +162,9 @@ export function getSkillBody(name) {
 
 /** Absolute path to a hand-tuned cloud override, or null if absent. */
 export function cloudOverridePath(name) {
-  const p = path.join(SKILLS_DIR, name, 'SKILL.cloud.md');
+  const resolved = resolveSkillName(name);
+  if (!resolved) return null;
+  const p = path.join(SKILLS_DIR, resolved, 'SKILL.cloud.md');
   return fs.existsSync(p) ? p : null;
 }
 

package/package.json

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

package/skills/help/SKILL.md

@@ -94,6 +94,14 @@ RDC SKILLS — manifest: .claude-plugin/plugin.json @ v{version}
   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
+
+  Extract the JSON-RPC envelope:
+  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":0,"method":"tools/list"}' \
+    | sed -n 's/^data: //p'
 
   List skills:
   curl -s -X POST https://rdc-skills.regendevcorp.com/mcp \
@@ -111,7 +119,7 @@ RDC SKILLS — manifest: .claude-plugin/plugin.json @ v{version}
   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":"build","variant":"cli"}}}'
+    -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"rdc_skill_get","arguments":{"name":"rdc:build","variant":"cli"}}}'
 
 ## Hard rules
 

package/tests/help-surface.test.mjs

@@ -20,10 +20,14 @@ const docs = Object.fromEntries(
 for (const [name, text] of Object.entries(docs)) {
   assert.match(text, /https:\/\/rdc-skills\.regendevcorp\.com\/mcp/, `${name} must expose production MCP endpoint`);
   assert.match(text, /Accept: application\/json, text\/event-stream/, `${name} must show Streamable HTTP Accept header`);
+  assert.match(text, /data:/, `${name} must explain Streamable HTTP SSE data lines`);
+  assert.match(text, /result\.content\[0\]\.text/, `${name} must explain where tool text lives`);
+  assert.match(text, /sed -n 's\/\^data: \/\/p'/, `${name} must include a plain curl SSE extraction example`);
   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, /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

@@ -32,6 +32,7 @@ import {
   getSkillBody,
   getCloudOverride,
   searchSkills,
+  resolveSkillName,
 } from '../lib/catalog.mjs';
 import { toCloudBody } from '../lib/cloud-rewrite.mjs';
 
@@ -96,6 +97,11 @@ function unitTests() {
   check('unit: getSkill(nonexistent) is null', getSkill('___nope___') === null);
   check('unit: search ranks exact name first', searchSkills('deploy')[0]?.name === 'deploy');
   check('unit: empty search returns []', searchSkills('').length === 0);
+  check('unit: resolves bare skill name', resolveSkillName('build') === 'build');
+  check('unit: resolves rdc slash skill name', resolveSkillName('rdc:build') === 'build');
+  check('unit: resolves leading slash command form', resolveSkillName('/rdc:build') === 'build');
+  check('unit: resolves specialist slash alias', resolveSkillName('rdc:brochurify') === 'rdc-brochurify');
+  check('unit: resolves non-rdc specialist name', resolveSkillName('lifeai-brochure-author') === 'lifeai-brochure-author');
 
   // Searchability gate — the dimension the first "100% coverage" missed. Every
   // catalog entry MUST carry triggers + usage (frontmatter or skills_meta) so
@@ -175,6 +181,11 @@ async function sweep(url, label, { compareSource }) {
   const unk = await mcp(url, { jsonrpc: '2.0', id: 20, method: 'tools/call', params: { name: 'rdc_skill_get', arguments: { name: '___nope___' } } });
   check(`${label}: unknown skill returns helpful error`, /unknown skill/i.test(callText(unk.json)));
 
+  // Alias path: callers naturally copy the slash form from rdc_skill_list.
+  const aliasGet = await mcp(url, { jsonrpc: '2.0', id: 22, method: 'tools/call', params: { name: 'rdc_skill_get', arguments: { name: 'rdc:brochurify', variant: 'cli' } } });
+  const aliasBody = strip(callText(aliasGet.json));
+  check(`${label}: rdc_skill_get accepts slash aliases`, /rdc:brochurify Orchestrator/.test(aliasBody));
+
   // 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: [] }; }