@julong/mono-rele2-core 1.30.0 → 1.32.0

package/README.md

@@ -47,6 +47,16 @@ Run without arguments to list all available tools:
 mono-rele2-core-cli
 ```
 
+## Skill Installation
+
+Install the CLI as a reusable skill for your AI agent:
+
+```sh
+npx skills add https://github.com/jl917/mcp-kit/tree/main/packages/core/skills
+```
+
+This registers all tools as callable skills in your agent's environment.
+
 ## Tools API Reference
 
 ### `echo(message)`

package/dist/cli.cjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+"use strict";function s(n){return{content:[{type:"text",text:n}]}}var T=require("@modelcontextprotocol/sdk/server/mcp.js"),h=require("@modelcontextprotocol/sdk/server/stdio.js");var c=require("zod");async function u(n){let[,,e,...m]=process.argv;(!e||!(e in n))&&(e&&console.error(`Unknown skill: "${e}"
+`),process.exit(e?1:0));let i=n[e],a=Object.keys(i.inputSchema),p={};for(let t=0;t<a.length;t++){let l=m[t];if(l!==void 0)try{p[a[t]]=JSON.parse(l)}catch{p[a[t]]=l}}let y=c.z.object(i.inputSchema).parse(p),g=await i.handler(y);for(let t of g.content)t.type==="text"&&console.log(t.text)}function d(n){n instanceof c.z.ZodError?console.error("Validation error:",n.issues.map(e=>`${e.path.join(".")}: ${e.message}`).join(", ")):console.error("Error:",n instanceof Error?n.message:String(n)),process.exit(1)}var Z=require("zod");var r=require("zod"),f=require("crypto"),o={echoTool:{name:"echo",description:"Returns the message as-is",inputSchema:{message:r.z.string().describe("Message to echo")},handler:async({message:n})=>s(n),examples:[{args:['"hello world"'],result:"hello world"}]},timestampTool:{name:"timestamp",description:"Returns the current UTC timestamp",inputSchema:{format:r.z.enum(["iso","unix"]).default("iso").describe("Timestamp format")},handler:async({format:n})=>{let e=n==="unix"?String(Date.now()):new Date().toISOString();return s(e)},examples:[{args:[],result:"2026-05-02T00:00:00.000Z"},{args:["unix"],result:"1746144000000"}]},envTool:{name:"env",description:"Returns the value of an environment variable",inputSchema:{key:r.z.string().describe("Environment variable name")},handler:async({key:n})=>s(process.env[n]??""),examples:[{args:["HOME"],result:"/Users/julong"},{args:["NODE_ENV"],result:"development"}],guidelines:["`envTool` returns an empty string when the variable is not set"]},uuidTool:{name:"uuid",description:"Generates a random UUID v4",inputSchema:{},handler:async()=>s((0,f.randomUUID)()),examples:[{args:[],result:"550e8400-e29b-41d4-a716-446655440000"}]}},B=o.echoTool,U=o.timestampTool,V=o.envTool,P=o.uuidTool;u(o).catch(d);

package/dist/cli.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-function s(n){return{content:[{type:"text",text:n}]}}import{McpServer as $}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as x}from"@modelcontextprotocol/sdk/server/stdio.js";import{z as c}from"zod";async function u(n){let[,,e,...f]=process.argv;(!e||!(e in n))&&(e&&console.error(`Unknown skill: "${e}"
+function s(n){return{content:[{type:"text",text:n}]}}import{McpServer as S}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as x}from"@modelcontextprotocol/sdk/server/stdio.js";import{z as c}from"zod";async function u(n){let[,,e,...f]=process.argv;(!e||!(e in n))&&(e&&console.error(`Unknown skill: "${e}"
 `),process.exit(e?1:0));let r=n[e],i=Object.keys(r.inputSchema),a={};for(let t=0;t<i.length;t++){let p=f[t];if(p!==void 0)try{a[i[t]]=JSON.parse(p)}catch{a[i[t]]=p}}let m=c.object(r.inputSchema).parse(a),y=await r.handler(m);for(let t of y.content)t.type==="text"&&console.log(t.text)}function d(n){n instanceof c.ZodError?console.error("Validation error:",n.issues.map(e=>`${e.path.join(".")}: ${e.message}`).join(", ")):console.error("Error:",n instanceof Error?n.message:String(n)),process.exit(1)}import{z}from"zod";import{z as l}from"zod";import{randomUUID as g}from"crypto";var o={echoTool:{name:"echo",description:"Returns the message as-is",inputSchema:{message:l.string().describe("Message to echo")},handler:async({message:n})=>s(n),examples:[{args:['"hello world"'],result:"hello world"}]},timestampTool:{name:"timestamp",description:"Returns the current UTC timestamp",inputSchema:{format:l.enum(["iso","unix"]).default("iso").describe("Timestamp format")},handler:async({format:n})=>{let e=n==="unix"?String(Date.now()):new Date().toISOString();return s(e)},examples:[{args:[],result:"2026-05-02T00:00:00.000Z"},{args:["unix"],result:"1746144000000"}]},envTool:{name:"env",description:"Returns the value of an environment variable",inputSchema:{key:l.string().describe("Environment variable name")},handler:async({key:n})=>s(process.env[n]??""),examples:[{args:["HOME"],result:"/Users/julong"},{args:["NODE_ENV"],result:"development"}],guidelines:["`envTool` returns an empty string when the variable is not set"]},uuidTool:{name:"uuid",description:"Generates a random UUID v4",inputSchema:{},handler:async()=>s(g()),examples:[{args:[],result:"550e8400-e29b-41d4-a716-446655440000"}]}},J=o.echoTool,G=o.timestampTool,K=o.envTool,q=o.uuidTool;u(o).catch(d);

package/dist/index.cjs

@@ -0,0 +1,63 @@
+"use strict";var h=Object.defineProperty;var w=Object.getOwnPropertyDescriptor;var z=Object.getOwnPropertyNames;var A=Object.prototype.hasOwnProperty;var O=(o,e)=>{for(var n in e)h(o,n,{get:e[n],enumerable:!0})},k=(o,e,n,t)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of z(e))!A.call(o,r)&&r!==n&&h(o,r,{get:()=>e[r],enumerable:!(t=w(e,r))||t.enumerable});return o};var v=o=>k(h({},"__esModule",{value:!0}),o);var K={};O(K,{generateReadmeSkills:()=>x,generateSkillMarkdown:()=>S,tools:()=>d});module.exports=v(K);function f(o){return{content:[{type:"text",text:o}]}}var R=require("@modelcontextprotocol/sdk/server/mcp.js"),N=require("@modelcontextprotocol/sdk/server/stdio.js");var E=require("zod");var i=require("zod");function S(o){let{binName:e,description:n,tools:t}=o;return`---
+name: ${e}
+description: ${n}
+---
+
+# ${e}
+
+\`\`\`sh
+${e} <toolName> [...args]
+\`\`\`
+
+## Skills
+
+${M(t)}
+
+## Examples
+
+${C(e,t)}
+
+## Guidelines
+
+${U(e,t)}
+`}function M(o){return Object.entries(o).map(([e,n])=>{let t=Object.entries(n.inputSchema).map(([a,s])=>{let l=n.typeLabels?.[a];return`| \`${a}\` | ${B(s,l)} |`}).join(`
+`),r=n.typeDefs?Object.entries(n.typeDefs).map(([a,s])=>`
+
+**\`${a}\`** type definition:
+\`\`\`typescript
+${s}
+\`\`\``).join(""):"";return`### ${e}
+
+${n.description}
+
+| arg | description |
+|-----|-------------|
+${t}${r}`}).join(`
+
+`)}function B(o,e){let n=o.description??"",t=o,r,a=!1;for(;t instanceof i.z.ZodOptional||t instanceof i.z.ZodDefault;){if(t instanceof i.z.ZodDefault){let l=t.def.defaultValue;r=typeof l=="function"?l():l}t instanceof i.z.ZodOptional&&(a=!0),t=t.unwrap()}let s=[];if(e&&s.push(`Type: ${e}`),n&&s.push(n),t instanceof i.z.ZodEnum){let l=t.options.map(m=>`\`${m}\``).join(" \\| ");s.push(l)}return r!==void 0?s.push(`default: \`${String(r)}\``):a&&s.push("optional"),s.join(" \u2014 ")}function C(o,e){let n=[];for(let[t,r]of Object.entries(e))if(r.examples)for(let a of r.examples){let s=[o,t,...a.args].join(" ");n.push(`- \`${s}\` => \`${a.result}\``)}return n.join(`
+`)}function U(o,e){let n=[],t=new Set,r=s=>{t.has(s)||(t.add(s),n.push(s))};r("Arguments are positional \u2014 pass them in the order listed in each skill's table");let a=Object.values(e).flatMap(s=>Object.values(s.inputSchema));a.some(s=>Z(s,i.z.ZodNumber))&&r("Numeric args are auto-parsed \u2014 pass as plain numbers (e.g. `10`)"),a.some(s=>Z(s,i.z.ZodArray))&&r('Array args must be valid JSON \u2014 wrap in single quotes on Unix shells (e.g. `\'["a","b"]\'`)'),a.some(s=>s instanceof i.z.ZodOptional||s instanceof i.z.ZodDefault)&&r("Optional args with defaults may be omitted");for(let s of Object.values(e))if(s.guidelines)for(let l of s.guidelines)r(l);return r(`Run \`${o}\` with no args to list all available skills`),n.map(s=>`- ${s}`).join(`
+`)}function Z(o,e){let n=o;for(;n instanceof i.z.ZodOptional||n instanceof i.z.ZodDefault;)n=n.unwrap();return n instanceof e}function x(o){let{binName:e,tools:n}=o;return Object.entries(n).map(([t,r])=>V(e,t,r)).join(`
+
+`)}function V(o,e,n){let t=Object.entries(n.inputSchema),r=t.map(([p,c])=>c instanceof i.z.ZodOptional||c instanceof i.z.ZodDefault?`[${p}]`:`<${p}>`).join(" "),a=[o,e,r].filter(Boolean).join(" "),s=t.map(([p,c])=>{let g=n.typeLabels?.[p],u=$(c,g),T=P(c);return`| \`${p}\` | ${u} | ${T} |`}).join(`
+`),l=n.examples??[],m="";if(l.length>0){let p=l.map(u=>[o,e,...u.args].join(" ")),c=Math.max(...p.map(u=>u.length));m=`
+
+\`\`\`sh
+${l.map((u,T)=>`${p[T].padEnd(c)}    # ${u.result}`).join(`
+`)}
+\`\`\``}let j=n.typeDefs?Object.entries(n.typeDefs).map(([p,c])=>`
+
+**\`${p}\`** type definition:
+
+\`\`\`typescript
+${c}
+\`\`\``).join(""):"",D=s?`
+
+| arg | type | description |
+|-----|------|-------------|
+${s}`:"";return`#### \`${e}\`
+
+${n.description}.
+
+\`\`\`sh
+${a}
+\`\`\`${D}${j}${m}`}function $(o,e){if(e)return e;let n=o;for(;n instanceof i.z.ZodOptional||n instanceof i.z.ZodDefault;)n=n.unwrap();return n instanceof i.z.ZodEnum?n.options.map(t=>`\`${t}\``).join(" \\| "):n instanceof i.z.ZodNumber?"number":n instanceof i.z.ZodString?"string":n instanceof i.z.ZodBoolean?"boolean":n instanceof i.z.ZodArray?"JSON string (array)":n instanceof i.z.ZodUnion?n.options.map(r=>$(r)).join(" \\| "):n instanceof i.z.ZodRecord?"JSON object":"unknown"}function P(o){let e=o.description??"",n=o,t,r=!1;for(;n instanceof i.z.ZodOptional||n instanceof i.z.ZodDefault;){if(n instanceof i.z.ZodDefault){let a=n.def.defaultValue;t=typeof a=="function"?a():a}n instanceof i.z.ZodOptional&&(r=!0),n=n.unwrap()}return t!==void 0?`${e} (default: \`${String(t)}\`)`:r?`${e} (optional)`:e}var y=require("zod"),b=require("crypto"),d={echoTool:{name:"echo",description:"Returns the message as-is",inputSchema:{message:y.z.string().describe("Message to echo")},handler:async({message:o})=>f(o),examples:[{args:['"hello world"'],result:"hello world"}]},timestampTool:{name:"timestamp",description:"Returns the current UTC timestamp",inputSchema:{format:y.z.enum(["iso","unix"]).default("iso").describe("Timestamp format")},handler:async({format:o})=>{let e=o==="unix"?String(Date.now()):new Date().toISOString();return f(e)},examples:[{args:[],result:"2026-05-02T00:00:00.000Z"},{args:["unix"],result:"1746144000000"}]},envTool:{name:"env",description:"Returns the value of an environment variable",inputSchema:{key:y.z.string().describe("Environment variable name")},handler:async({key:o})=>f(process.env[o]??""),examples:[{args:["HOME"],result:"/Users/julong"},{args:["NODE_ENV"],result:"development"}],guidelines:["`envTool` returns an empty string when the variable is not set"]},uuidTool:{name:"uuid",description:"Generates a random UUID v4",inputSchema:{},handler:async()=>f((0,b.randomUUID)()),examples:[{args:[],result:"550e8400-e29b-41d4-a716-446655440000"}]}},I=d.echoTool,L=d.timestampTool,J=d.envTool,G=d.uuidTool;0&&(module.exports={generateReadmeSkills,generateSkillMarkdown,tools});

package/dist/index.d.cts

@@ -0,0 +1,111 @@
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+
+type ToolResult = CallToolResult;
+type ToolExample = {
+    args: string[];
+    result: string;
+};
+type AnyToolDef = {
+    name: string;
+    description: string;
+    inputSchema: z.ZodRawShape;
+    handler: (args: any) => Promise<ToolResult>;
+    examples?: ToolExample[];
+    guidelines?: string[];
+    typeLabels?: Record<string, string>;
+    typeDefs?: Record<string, string>;
+    returnType?: string;
+    returnDescription?: string;
+};
+
+type SkillTools = Record<string, AnyToolDef>;
+declare function generateSkillMarkdown(opts: {
+    binName: string;
+    description: string;
+    tools: SkillTools;
+}): string;
+declare function generateReadmeSkills(opts: {
+    binName: string;
+    tools: SkillTools;
+}): string;
+
+declare const tools: {
+    echoTool: {
+        name: string;
+        description: string;
+        inputSchema: {
+            readonly message: z.ZodString;
+        };
+        handler: (input: {
+            message: string;
+        }) => Promise<ToolResult>;
+        examples?: ToolExample[];
+        guidelines?: string[];
+        typeLabels?: {
+            readonly message?: string | undefined;
+        } | undefined;
+        typeDefs?: {
+            readonly message?: string | undefined;
+        } | undefined;
+        returnType?: string;
+        returnDescription?: string;
+    };
+    timestampTool: {
+        name: string;
+        description: string;
+        inputSchema: {
+            readonly format: z.ZodDefault<z.ZodEnum<{
+                iso: "iso";
+                unix: "unix";
+            }>>;
+        };
+        handler: (input: {
+            format: "iso" | "unix";
+        }) => Promise<ToolResult>;
+        examples?: ToolExample[];
+        guidelines?: string[];
+        typeLabels?: {
+            readonly format?: string | undefined;
+        } | undefined;
+        typeDefs?: {
+            readonly format?: string | undefined;
+        } | undefined;
+        returnType?: string;
+        returnDescription?: string;
+    };
+    envTool: {
+        name: string;
+        description: string;
+        inputSchema: {
+            readonly key: z.ZodString;
+        };
+        handler: (input: {
+            key: string;
+        }) => Promise<ToolResult>;
+        examples?: ToolExample[];
+        guidelines?: string[];
+        typeLabels?: {
+            readonly key?: string | undefined;
+        } | undefined;
+        typeDefs?: {
+            readonly key?: string | undefined;
+        } | undefined;
+        returnType?: string;
+        returnDescription?: string;
+    };
+    uuidTool: {
+        name: string;
+        description: string;
+        inputSchema: {};
+        handler: (input: Record<string, never>) => Promise<ToolResult>;
+        examples?: ToolExample[];
+        guidelines?: string[];
+        typeLabels?: {} | undefined;
+        typeDefs?: {} | undefined;
+        returnType?: string;
+        returnDescription?: string;
+    };
+};
+
+export { generateReadmeSkills, generateSkillMarkdown, tools };

package/dist/index.js

@@ -1,63 +1,63 @@
-function f(s){return{content:[{type:"text",text:s}]}}import{McpServer as U}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as L}from"@modelcontextprotocol/sdk/server/stdio.js";import{z as J}from"zod";import{z as r}from"zod";function x(s){let{binName:t,description:n,tools:o}=s;return`---
-name: ${t}
+function f(s){return{content:[{type:"text",text:s}]}}import{McpServer as U}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as P}from"@modelcontextprotocol/sdk/server/stdio.js";import{z as J}from"zod";import{z as r}from"zod";function $(s){let{binName:o,description:n,tools:t}=s;return`---
+name: ${o}
 description: ${n}
 ---
 
-# ${t}
+# ${o}
 
 \`\`\`sh
-${t} <toolName> [...args]
+${o} <toolName> [...args]
 \`\`\`
 
 ## Skills
 
-${b(o)}
+${b(t)}
 
 ## Examples
 
-${D(t,o)}
+${D(o,t)}
 
 ## Guidelines
 
-${w(t,o)}
-`}function b(s){return Object.entries(s).map(([t,n])=>{let o=Object.entries(n.inputSchema).map(([a,e])=>{let l=n.typeLabels?.[a];return`| \`${a}\` | ${j(e,l)} |`}).join(`
+${w(o,t)}
+`}function b(s){return Object.entries(s).map(([o,n])=>{let t=Object.entries(n.inputSchema).map(([a,e])=>{let l=n.typeLabels?.[a];return`| \`${a}\` | ${j(e,l)} |`}).join(`
 `),i=n.typeDefs?Object.entries(n.typeDefs).map(([a,e])=>`
 
 **\`${a}\`** type definition:
 \`\`\`typescript
 ${e}
-\`\`\``).join(""):"";return`### ${t}
+\`\`\``).join(""):"";return`### ${o}
 
 ${n.description}
 
 | arg | description |
 |-----|-------------|
-${o}${i}`}).join(`
+${t}${i}`}).join(`
 
-`)}function j(s,t){let n=s.description??"",o=s,i,a=!1;for(;o instanceof r.ZodOptional||o instanceof r.ZodDefault;){if(o instanceof r.ZodDefault){let l=o.def.defaultValue;i=typeof l=="function"?l():l}o instanceof r.ZodOptional&&(a=!0),o=o.unwrap()}let e=[];if(t&&e.push(`Type: ${t}`),n&&e.push(n),o instanceof r.ZodEnum){let l=o.options.map(m=>`\`${m}\``).join(" \\| ");e.push(l)}return i!==void 0?e.push(`default: \`${String(i)}\``):a&&e.push("optional"),e.join(" \u2014 ")}function D(s,t){let n=[];for(let[o,i]of Object.entries(t))if(i.examples)for(let a of i.examples){let e=[s,o,...a.args].join(" ");n.push(`- \`${e}\` => \`${a.result}\``)}return n.join(`
-`)}function w(s,t){let n=[],o=new Set,i=e=>{o.has(e)||(o.add(e),n.push(e))};i("Arguments are positional \u2014 pass them in the order listed in each skill's table");let a=Object.values(t).flatMap(e=>Object.values(e.inputSchema));a.some(e=>h(e,r.ZodNumber))&&i("Numeric args are auto-parsed \u2014 pass as plain numbers (e.g. `10`)"),a.some(e=>h(e,r.ZodArray))&&i('Array args must be valid JSON \u2014 wrap in single quotes on Unix shells (e.g. `\'["a","b"]\'`)'),a.some(e=>e instanceof r.ZodOptional||e instanceof r.ZodDefault)&&i("Optional args with defaults may be omitted");for(let e of Object.values(t))if(e.guidelines)for(let l of e.guidelines)i(l);return i(`Run \`${s}\` with no args to list all available skills`),n.map(e=>`- ${e}`).join(`
-`)}function h(s,t){let n=s;for(;n instanceof r.ZodOptional||n instanceof r.ZodDefault;)n=n.unwrap();return n instanceof t}function z(s){let{binName:t,tools:n}=s;return Object.entries(n).map(([o,i])=>A(t,o,i)).join(`
+`)}function j(s,o){let n=s.description??"",t=s,i,a=!1;for(;t instanceof r.ZodOptional||t instanceof r.ZodDefault;){if(t instanceof r.ZodDefault){let l=t.def.defaultValue;i=typeof l=="function"?l():l}t instanceof r.ZodOptional&&(a=!0),t=t.unwrap()}let e=[];if(o&&e.push(`Type: ${o}`),n&&e.push(n),t instanceof r.ZodEnum){let l=t.options.map(m=>`\`${m}\``).join(" \\| ");e.push(l)}return i!==void 0?e.push(`default: \`${String(i)}\``):a&&e.push("optional"),e.join(" \u2014 ")}function D(s,o){let n=[];for(let[t,i]of Object.entries(o))if(i.examples)for(let a of i.examples){let e=[s,t,...a.args].join(" ");n.push(`- \`${e}\` => \`${a.result}\``)}return n.join(`
+`)}function w(s,o){let n=[],t=new Set,i=e=>{t.has(e)||(t.add(e),n.push(e))};i("Arguments are positional \u2014 pass them in the order listed in each skill's table");let a=Object.values(o).flatMap(e=>Object.values(e.inputSchema));a.some(e=>h(e,r.ZodNumber))&&i("Numeric args are auto-parsed \u2014 pass as plain numbers (e.g. `10`)"),a.some(e=>h(e,r.ZodArray))&&i('Array args must be valid JSON \u2014 wrap in single quotes on Unix shells (e.g. `\'["a","b"]\'`)'),a.some(e=>e instanceof r.ZodOptional||e instanceof r.ZodDefault)&&i("Optional args with defaults may be omitted");for(let e of Object.values(o))if(e.guidelines)for(let l of e.guidelines)i(l);return i(`Run \`${s}\` with no args to list all available skills`),n.map(e=>`- ${e}`).join(`
+`)}function h(s,o){let n=s;for(;n instanceof r.ZodOptional||n instanceof r.ZodDefault;)n=n.unwrap();return n instanceof o}function z(s){let{binName:o,tools:n}=s;return Object.entries(n).map(([t,i])=>A(o,t,i)).join(`
 
-`)}function A(s,t,n){let o=Object.entries(n.inputSchema),i=o.map(([p,c])=>c instanceof r.ZodOptional||c instanceof r.ZodDefault?`[${p}]`:`<${p}>`).join(" "),a=[s,t,i].filter(Boolean).join(" "),e=o.map(([p,c])=>{let y=n.typeLabels?.[p],u=Z(c,y),g=O(c);return`| \`${p}\` | ${u} | ${g} |`}).join(`
-`),l=n.examples??[],m="";if(l.length>0){let p=l.map(u=>[s,t,...u.args].join(" ")),c=Math.max(...p.map(u=>u.length));m=`
+`)}function A(s,o,n){let t=Object.entries(n.inputSchema),i=t.map(([p,c])=>c instanceof r.ZodOptional||c instanceof r.ZodDefault?`[${p}]`:`<${p}>`).join(" "),a=[s,o,i].filter(Boolean).join(" "),e=t.map(([p,c])=>{let y=n.typeLabels?.[p],u=Z(c,y),g=O(c);return`| \`${p}\` | ${u} | ${g} |`}).join(`
+`),l=n.examples??[],m="";if(l.length>0){let p=l.map(u=>[s,o,...u.args].join(" ")),c=Math.max(...p.map(u=>u.length));m=`
 
 \`\`\`sh
 ${l.map((u,g)=>`${p[g].padEnd(c)}    # ${u.result}`).join(`
 `)}
-\`\`\``}let $=n.typeDefs?Object.entries(n.typeDefs).map(([p,c])=>`
+\`\`\``}let S=n.typeDefs?Object.entries(n.typeDefs).map(([p,c])=>`
 
 **\`${p}\`** type definition:
 
 \`\`\`typescript
 ${c}
-\`\`\``).join(""):"",S=e?`
+\`\`\``).join(""):"",x=e?`
 
 | arg | type | description |
 |-----|------|-------------|
-${e}`:"";return`#### \`${t}\`
+${e}`:"";return`#### \`${o}\`
 
 ${n.description}.
 
 \`\`\`sh
 ${a}
-\`\`\`${S}${$}${m}`}function Z(s,t){if(t)return t;let n=s;for(;n instanceof r.ZodOptional||n instanceof r.ZodDefault;)n=n.unwrap();return n instanceof r.ZodEnum?n.options.map(o=>`\`${o}\``).join(" \\| "):n instanceof r.ZodNumber?"number":n instanceof r.ZodString?"string":n instanceof r.ZodBoolean?"boolean":n instanceof r.ZodArray?"JSON string (array)":n instanceof r.ZodUnion?n.options.map(i=>Z(i)).join(" \\| "):n instanceof r.ZodRecord?"JSON object":"unknown"}function O(s){let t=s.description??"",n=s,o,i=!1;for(;n instanceof r.ZodOptional||n instanceof r.ZodDefault;){if(n instanceof r.ZodDefault){let a=n.def.defaultValue;o=typeof a=="function"?a():a}n instanceof r.ZodOptional&&(i=!0),n=n.unwrap()}return o!==void 0?`${t} (default: \`${String(o)}\`)`:i?`${t} (optional)`:t}import{z as T}from"zod";import{randomUUID as k}from"crypto";var d={echoTool:{name:"echo",description:"Returns the message as-is",inputSchema:{message:T.string().describe("Message to echo")},handler:async({message:s})=>f(s),examples:[{args:['"hello world"'],result:"hello world"}]},timestampTool:{name:"timestamp",description:"Returns the current UTC timestamp",inputSchema:{format:T.enum(["iso","unix"]).default("iso").describe("Timestamp format")},handler:async({format:s})=>{let t=s==="unix"?String(Date.now()):new Date().toISOString();return f(t)},examples:[{args:[],result:"2026-05-02T00:00:00.000Z"},{args:["unix"],result:"1746144000000"}]},envTool:{name:"env",description:"Returns the value of an environment variable",inputSchema:{key:T.string().describe("Environment variable name")},handler:async({key:s})=>f(process.env[s]??""),examples:[{args:["HOME"],result:"/Users/julong"},{args:["NODE_ENV"],result:"development"}],guidelines:["`envTool` returns an empty string when the variable is not set"]},uuidTool:{name:"uuid",description:"Generates a random UUID v4",inputSchema:{},handler:async()=>f(k()),examples:[{args:[],result:"550e8400-e29b-41d4-a716-446655440000"}]}},v=d.echoTool,R=d.timestampTool,E=d.envTool,N=d.uuidTool;export{z as generateReadmeSkills,x as generateSkillMarkdown,d as tools};
+\`\`\`${x}${S}${m}`}function Z(s,o){if(o)return o;let n=s;for(;n instanceof r.ZodOptional||n instanceof r.ZodDefault;)n=n.unwrap();return n instanceof r.ZodEnum?n.options.map(t=>`\`${t}\``).join(" \\| "):n instanceof r.ZodNumber?"number":n instanceof r.ZodString?"string":n instanceof r.ZodBoolean?"boolean":n instanceof r.ZodArray?"JSON string (array)":n instanceof r.ZodUnion?n.options.map(i=>Z(i)).join(" \\| "):n instanceof r.ZodRecord?"JSON object":"unknown"}function O(s){let o=s.description??"",n=s,t,i=!1;for(;n instanceof r.ZodOptional||n instanceof r.ZodDefault;){if(n instanceof r.ZodDefault){let a=n.def.defaultValue;t=typeof a=="function"?a():a}n instanceof r.ZodOptional&&(i=!0),n=n.unwrap()}return t!==void 0?`${o} (default: \`${String(t)}\`)`:i?`${o} (optional)`:o}import{z as T}from"zod";import{randomUUID as k}from"crypto";var d={echoTool:{name:"echo",description:"Returns the message as-is",inputSchema:{message:T.string().describe("Message to echo")},handler:async({message:s})=>f(s),examples:[{args:['"hello world"'],result:"hello world"}]},timestampTool:{name:"timestamp",description:"Returns the current UTC timestamp",inputSchema:{format:T.enum(["iso","unix"]).default("iso").describe("Timestamp format")},handler:async({format:s})=>{let o=s==="unix"?String(Date.now()):new Date().toISOString();return f(o)},examples:[{args:[],result:"2026-05-02T00:00:00.000Z"},{args:["unix"],result:"1746144000000"}]},envTool:{name:"env",description:"Returns the value of an environment variable",inputSchema:{key:T.string().describe("Environment variable name")},handler:async({key:s})=>f(process.env[s]??""),examples:[{args:["HOME"],result:"/Users/julong"},{args:["NODE_ENV"],result:"development"}],guidelines:["`envTool` returns an empty string when the variable is not set"]},uuidTool:{name:"uuid",description:"Generates a random UUID v4",inputSchema:{},handler:async()=>f(k()),examples:[{args:[],result:"550e8400-e29b-41d4-a716-446655440000"}]}},v=d.echoTool,R=d.timestampTool,N=d.envTool,E=d.uuidTool;export{z as generateReadmeSkills,$ as generateSkillMarkdown,d as tools};

package/dist/server.cjs

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+"use strict";function o(e){return{content:[{type:"text",text:e}]}}var u=require("@modelcontextprotocol/sdk/server/mcp.js"),d=require("@modelcontextprotocol/sdk/server/stdio.js");function f(e,n){let c=new u.McpServer(e);for(let s of n)c.registerTool(s.name,{description:s.description,inputSchema:s.inputSchema},s.handler);return c}async function m(e){let n=new d.StdioServerTransport;await e.connect(n)}var g=require("zod");var T=require("zod");var r=require("zod"),y=require("crypto"),t={echoTool:{name:"echo",description:"Returns the message as-is",inputSchema:{message:r.z.string().describe("Message to echo")},handler:async({message:e})=>o(e),examples:[{args:['"hello world"'],result:"hello world"}]},timestampTool:{name:"timestamp",description:"Returns the current UTC timestamp",inputSchema:{format:r.z.enum(["iso","unix"]).default("iso").describe("Timestamp format")},handler:async({format:e})=>{let n=e==="unix"?String(Date.now()):new Date().toISOString();return o(n)},examples:[{args:[],result:"2026-05-02T00:00:00.000Z"},{args:["unix"],result:"1746144000000"}]},envTool:{name:"env",description:"Returns the value of an environment variable",inputSchema:{key:r.z.string().describe("Environment variable name")},handler:async({key:e})=>o(process.env[e]??""),examples:[{args:["HOME"],result:"/Users/julong"},{args:["NODE_ENV"],result:"development"}],guidelines:["`envTool` returns an empty string when the variable is not set"]},uuidTool:{name:"uuid",description:"Generates a random UUID v4",inputSchema:{},handler:async()=>o((0,y.randomUUID)()),examples:[{args:[],result:"550e8400-e29b-41d4-a716-446655440000"}]}},i=t.echoTool,a=t.timestampTool,l=t.envTool,p=t.uuidTool;var h=f({name:"mono-rele2-core",version:"1.0.0"},[i,a,l,p]);m(h).catch(e=>{console.error("[core] server error:",e),process.exit(1)});

package/dist/server.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-function o(n){return{content:[{type:"text",text:n}]}}import{McpServer as f}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as m}from"@modelcontextprotocol/sdk/server/stdio.js";function u(n,e){let c=new f(n);for(let s of e)c.registerTool(s.name,{description:s.description,inputSchema:s.inputSchema},s.handler);return c}async function d(n){let e=new m;await n.connect(e)}import{z as b}from"zod";import{z as w}from"zod";import{z as r}from"zod";import{randomUUID as y}from"crypto";var t={echoTool:{name:"echo",description:"Returns the message as-is",inputSchema:{message:r.string().describe("Message to echo")},handler:async({message:n})=>o(n),examples:[{args:['"hello world"'],result:"hello world"}]},timestampTool:{name:"timestamp",description:"Returns the current UTC timestamp",inputSchema:{format:r.enum(["iso","unix"]).default("iso").describe("Timestamp format")},handler:async({format:n})=>{let e=n==="unix"?String(Date.now()):new Date().toISOString();return o(e)},examples:[{args:[],result:"2026-05-02T00:00:00.000Z"},{args:["unix"],result:"1746144000000"}]},envTool:{name:"env",description:"Returns the value of an environment variable",inputSchema:{key:r.string().describe("Environment variable name")},handler:async({key:n})=>o(process.env[n]??""),examples:[{args:["HOME"],result:"/Users/julong"},{args:["NODE_ENV"],result:"development"}],guidelines:["`envTool` returns an empty string when the variable is not set"]},uuidTool:{name:"uuid",description:"Generates a random UUID v4",inputSchema:{},handler:async()=>o(y()),examples:[{args:[],result:"550e8400-e29b-41d4-a716-446655440000"}]}},i=t.echoTool,a=t.timestampTool,p=t.envTool,l=t.uuidTool;var g=u({name:"mono-rele2-core",version:"1.0.0"},[i,a,p,l]);d(g).catch(n=>{console.error("[core] server error:",n),process.exit(1)});
+function o(e){return{content:[{type:"text",text:e}]}}import{McpServer as f}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as m}from"@modelcontextprotocol/sdk/server/stdio.js";function u(e,n){let c=new f(e);for(let s of n)c.registerTool(s.name,{description:s.description,inputSchema:s.inputSchema},s.handler);return c}async function d(e){let n=new m;await e.connect(n)}import{z as b}from"zod";import{z as w}from"zod";import{z as r}from"zod";import{randomUUID as y}from"crypto";var t={echoTool:{name:"echo",description:"Returns the message as-is",inputSchema:{message:r.string().describe("Message to echo")},handler:async({message:e})=>o(e),examples:[{args:['"hello world"'],result:"hello world"}]},timestampTool:{name:"timestamp",description:"Returns the current UTC timestamp",inputSchema:{format:r.enum(["iso","unix"]).default("iso").describe("Timestamp format")},handler:async({format:e})=>{let n=e==="unix"?String(Date.now()):new Date().toISOString();return o(n)},examples:[{args:[],result:"2026-05-02T00:00:00.000Z"},{args:["unix"],result:"1746144000000"}]},envTool:{name:"env",description:"Returns the value of an environment variable",inputSchema:{key:r.string().describe("Environment variable name")},handler:async({key:e})=>o(process.env[e]??""),examples:[{args:["HOME"],result:"/Users/julong"},{args:["NODE_ENV"],result:"development"}],guidelines:["`envTool` returns an empty string when the variable is not set"]},uuidTool:{name:"uuid",description:"Generates a random UUID v4",inputSchema:{},handler:async()=>o(y()),examples:[{args:[],result:"550e8400-e29b-41d4-a716-446655440000"}]}},i=t.echoTool,a=t.timestampTool,l=t.envTool,p=t.uuidTool;var g=u({name:"mono-rele2-core",version:"1.0.0"},[i,a,l,p]);d(g).catch(e=>{console.error("[core] server error:",e),process.exit(1)});

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@julong/mono-rele2-core",
-  "version": "1.30.0",
+  "version": "1.32.0",
   "description": "Use this skill to invoke core system utility functions via the mono-rele2-core CLI. Handles message echo, UTC timestamp generation, and environment variable lookup.",
   "license": "ISC",
   "type": "module",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.cjs"
     }
   },
   "bin": {
@@ -22,8 +23,12 @@
   },
   "scripts": {
     "build": "tsup",
+    "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
     "clean": "rimraf dist",
+    "lint": "rslint --config ../../rslint.config.ts .",
+    "format": "prettier --write src/ --write '*.{ts,json,js}'",
+    "format:check": "prettier --check src/ --check '*.{ts,json,js}'",
     "readme": "bun ../common/build/update-readme.mjs"
   },
   "dependencies": {

package/dist/skills/mono-rele2-core-cli/skill.md

@@ -1,60 +0,0 @@
----
-name: mono-rele2-core-cli
-description: Use this skill to invoke core system utility functions via the mono-rele2-core CLI. Handles message echo, UTC timestamp generation, and environment variable lookup.
----
-
-# mono-rele2-core-cli
-
-```sh
-mono-rele2-core-cli <toolName> [...args]
-```
-
-## Skills
-
-### echoTool
-
-Returns the message as-is
-
-| arg | description |
-|-----|-------------|
-| `message` | Message to echo |
-
-### timestampTool
-
-Returns the current UTC timestamp
-
-| arg | description |
-|-----|-------------|
-| `format` | Timestamp format — `iso` \| `unix` — default: `iso` |
-
-### envTool
-
-Returns the value of an environment variable
-
-| arg | description |
-|-----|-------------|
-| `key` | Environment variable name |
-
-### uuidTool
-
-Generates a random UUID v4
-
-| arg | description |
-|-----|-------------|
-
-
-## Examples
-
-- `mono-rele2-core-cli echoTool "hello world"` => `hello world`
-- `mono-rele2-core-cli timestampTool` => `2026-05-02T00:00:00.000Z`
-- `mono-rele2-core-cli timestampTool unix` => `1746144000000`
-- `mono-rele2-core-cli envTool HOME` => `/Users/julong`
-- `mono-rele2-core-cli envTool NODE_ENV` => `development`
-- `mono-rele2-core-cli uuidTool` => `550e8400-e29b-41d4-a716-446655440000`
-
-## Guidelines
-
-- Arguments are positional — pass them in the order listed in each skill's table
-- Optional args with defaults may be omitted
-- `envTool` returns an empty string when the variable is not set
-- Run `mono-rele2-core-cli` with no args to list all available skills