@wipcomputer/wip-ldm-os 0.4.48 → 0.4.50

package/SKILL.md

@@ -9,7 +9,7 @@ license: MIT
 compatibility: Requires git, npm, node. Node.js 18+.
 metadata:
   display-name: "LDM OS"
-  version: "0.4.48"
+  version: "0.4.50"
   homepage: "https://github.com/wipcomputer/wip-ldm-os"
   author: "Parker Todd Brooks"
   category: infrastructure

package/docs/universal-installer/README.md

@@ -15,7 +15,7 @@ The chiclets at the top of this README tell you what interfaces this repo ships.
 | **npm** | Published to npm. Installable via `npm install`. Versioned, dependency-managed, standard distribution. |
 | **CLI / TUI** | Ships a command-line interface. Humans run it in a terminal. Agents call it from shell. The most portable interface there is. |
 | **OpenClaw Skill** | Registered as a skill on [ClawHub](https://clawhub.ai). OpenClaw agents can discover and use it natively through the gateway. |
-| **Claude Code Skill** | Has a `SKILL.md` that teaches Claude Code (and any agent that reads markdown) when to use this tool, what it does, and how to call it. The agent reads the file and learns the capability. |
+| **Claude Code Skill** | Has a `SKILL.md` that teaches Claude Code (and any agent that reads markdown) when to use this tool, what it does, and how to call it. Follows the [Agent Skills Spec](https://agentskills.io/specification). Process in SKILL.md, context in `references/`. |
 | **Universal Interface Spec** | Follows the [TECHNICAL.md](TECHNICAL.md) convention. The repo's architecture is documented, the interfaces are declared, and any agent or human can understand the full surface area by reading one file. |
 
 When you see these badges on a WIP repo, you know exactly how to consume it. Human or agent, CLI or plugin, local or remote. That's the point.

package/docs/universal-installer/SPEC.md

@@ -76,19 +76,35 @@ A plugin for OpenClaw agents. Lifecycle hooks, tool registration, settings.
 
 ### 5. Skill (SKILL.md)
 
-A markdown file that teaches agents when and how to use the tool. The instruction interface.
+A markdown file that teaches agents when and how to use the tool. The instruction interface. Follows the [Agent Skills Spec](https://agentskills.io/specification).
 
-**Convention:** `SKILL.md` at the repo root. YAML frontmatter with name, version, description, metadata.
+**Convention:** `SKILL.md` at the repo root. YAML frontmatter with name, description. Optional `references/` directory for context files.
 
 **Detection:** `SKILL.md` exists.
 
-**Install:** Referenced by path. Agents read it when they need the tool.
+**Install:** `SKILL.md` deployed to `~/.openclaw/skills/<name>/`. If `references/` exists, deployed alongside SKILL.md and to `settings/docs/skills/<name>/` in the workspace.
+
+**Structure:**
+```
+repo/
+├── SKILL.md          # < 150 lines. Process only. Imperative instructions.
+└── references/       # Optional. Context files loaded on demand.
+    ├── PRODUCT.md    # What the product is
+    ├── TOOLS.md      # MCP tools, CLI commands
+    └── ...
+```
+
+**Key rules (from Agent Skills Spec):**
+- SKILL.md body < 5000 tokens. Process goes in SKILL.md, context goes in references/.
+- Imperative language: "Run this command" not "This product enables..."
+- Progressive disclosure: metadata loaded at startup, body on activation, references on demand.
 
 ```yaml
 ---
 name: wip-grok
-version: 1.0.0
-description: xAI Grok API. Search the web, search X, generate images.
+description: >
+  xAI Grok API. Search the web, search X, generate images.
+  Use when asked to search, browse, or generate images.
 metadata:
   category: search,media
   capabilities:

package/docs/universal-installer/TECHNICAL.md

@@ -106,19 +106,24 @@ A plugin for OpenClaw agents. Lifecycle hooks, tool registration, settings.
 
 ### 5. Skill (SKILL.md)
 
-A markdown file that teaches agents when and how to use the tool. The instruction interface.
+A markdown file that teaches agents when and how to use the tool. The instruction interface. Follows the [Agent Skills Spec](https://agentskills.io/specification).
 
-**Convention:** `SKILL.md` at the repo root. YAML frontmatter with name, version, description, metadata.
+**Convention:** `SKILL.md` at the repo root. Optional `references/` directory for context files.
 
 **Detection:** `SKILL.md` exists.
 
-**Install:** Referenced by path. Agents read it when they need the tool.
+**Install:** `ldm install` deploys `SKILL.md` to `~/.openclaw/skills/<name>/`. If `references/` exists, it is deployed alongside and also to `settings/docs/skills/<name>/` in the workspace (so all agents can read them).
+
+**Key rules:**
+- SKILL.md body < 5000 tokens. Process in SKILL.md, context in references/.
+- references/ files are loaded on demand, not on every activation.
 
 ```yaml
 ---
 name: wip-grok
-version: 1.0.0
-description: xAI Grok API. Search the web, search X, generate images.
+description: >
+  xAI Grok API. Search the web, search X, generate images.
+  Use when asked to search, browse, or generate images.
 metadata:
   category: search,media
   capabilities:

package/lib/deploy.mjs

@@ -671,9 +671,45 @@ function installSkill(repoPath, toolName) {
   }
 
   try {
+    // Deploy to OpenClaw (~/.openclaw/skills/)
     mkdirSync(ocSkillDir, { recursive: true });
     cpSync(skillSrc, ocSkillDest);
-    ok(`Skill: deployed to ${ocSkillDir}`);
+
+    // Deploy to Claude Code (~/.claude/skills/) - standard discovery path
+    const ccSkillDir = join(HOME, '.claude', 'skills', toolName);
+    if (existsSync(join(HOME, '.claude'))) {
+      mkdirSync(ccSkillDir, { recursive: true });
+      cpSync(skillSrc, join(ccSkillDir, 'SKILL.md'));
+    }
+
+    ok(`Skill: deployed to ~/.openclaw/skills/ and ~/.claude/skills/`);
+
+    // Deploy references/ if it exists (Agent Skills Spec pattern)
+    const refsSrc = join(repoPath, 'references');
+    if (existsSync(refsSrc)) {
+      // To OpenClaw skill dir
+      cpSync(refsSrc, join(ocSkillDir, 'references'), { recursive: true });
+      // To Claude Code skill dir
+      if (existsSync(ccSkillDir)) {
+        cpSync(refsSrc, join(ccSkillDir, 'references'), { recursive: true });
+      }
+
+      // Also deploy to home (settings/docs/skills/) so all agents can read them
+      try {
+        const ldmConfigPath = join(LDM_ROOT, 'config.json');
+        if (existsSync(ldmConfigPath)) {
+          const ldmConfig = JSON.parse(readFileSync(ldmConfigPath, 'utf8'));
+          const workspace = (ldmConfig.workspace || '').replace('~', HOME);
+          if (workspace && existsSync(workspace)) {
+            const homeRefsDest = join(workspace, 'settings', 'docs', 'skills', toolName);
+            mkdirSync(homeRefsDest, { recursive: true });
+            cpSync(refsSrc, homeRefsDest, { recursive: true });
+            ok(`Skill: references/ deployed to ${homeRefsDest.replace(HOME, '~')}`);
+          }
+        }
+      } catch {}
+    }
+
     return true;
   } catch (e) {
     fail(`Skill: deploy failed. ${e.message}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-ldm-os",
-  "version": "0.4.48",
+  "version": "0.4.50",
   "type": "module",
   "description": "LDM OS: identity, memory, and sovereignty infrastructure for AI agents",
   "engines": {