@drunkcoding/agents-and-skills 0.0.32 → 0.0.34

package/.claude-plugin/marketplace.json

@@ -12,7 +12,7 @@
       "name": "tech-graph",
       "source": "./plugins/tech-graph",
       "description": "6-step wizard for technical diagrams (SVG/PNG) via fireworks-tech-graph",
-      "version": "0.0.32",
+      "version": "0.0.34",
       "category": "diagram",
       "keywords": [
         "diagram",
@@ -26,7 +26,7 @@
       "name": "html-effectiveness",
       "source": "./plugins/html-effectiveness",
       "description": "Generate self-contained interactive HTML reports from 20 upstream templates via a conversational agent.",
-      "version": "0.0.32",
+      "version": "0.0.34",
       "category": "reports",
       "keywords": [
         "html",
@@ -41,7 +41,7 @@
       "name": "plugin-validator",
       "source": "./plugins/plugin-validator",
       "description": "Orchestrated validator for Claude Code plugins — validates skills, agents, commands, and hooks across every plugin under plugins/**.",
-      "version": "0.0.32",
+      "version": "0.0.34",
       "category": "tooling",
       "keywords": [
         "validation",
@@ -57,7 +57,7 @@
       "name": "team-share",
       "source": "./plugins/team-share",
       "description": "Onboard your team with an interactive setup menu: install CodeGraph, build the Understand-Anything knowledge graph, and share Claude Code settings — run any combination, all idempotent.",
-      "version": "0.0.32",
+      "version": "0.0.34",
       "category": "tooling",
       "keywords": [
         "onboarding",
@@ -73,7 +73,7 @@
       "name": "multica-tool",
       "source": "./plugins/multica-tool",
       "description": "Export, import, and sync Multica skills, agents, and squads between workspaces.",
-      "version": "0.0.32",
+      "version": "0.0.34",
       "category": "workflow",
       "keywords": [
         "multica",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drunkcoding/agents-and-skills",
-  "version": "0.0.32",
+  "version": "0.0.34",
   "description": "Personal collection of Claude Code skills and agents, installable via `npx skills`.",
   "keywords": [
     "claude-code",

package/plugins/html-effectiveness/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "html-effectiveness",
   "displayName": "HTML Effectiveness Reports",
-  "version": "0.0.32",
+  "version": "0.0.34",
   "description": "Generate self-contained interactive HTML reports from 20 upstream templates via a conversational agent.",
   "author": {
     "name": "Steven Hoang"

package/plugins/multica-tool/.claude-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "multica-tool",
-  "version": "0.0.32",
+  "version": "0.0.34",
   "description": "Export, import, and sync Multica skills, agents, and squads between workspaces via the multica CLI."
 }

package/plugins/multica-tool/scripts/build-dist.mjs

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+// Generate OpenCode discovery artifacts from the canonical Claude Code plugin.
+// Source of truth: this plugin's skills/ + agents/ + commands/ + scripts/.
+// Output: dist/opencode/{skills,agents,commands}/ — copy into .opencode/ (project)
+// or ~/.config/opencode/ (global). Run: node plugins/multica-tool/scripts/build-dist.mjs
+import { readFileSync, writeFileSync, mkdirSync, readdirSync, rmSync, copyFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const PLUGIN_ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
+const REPO_ROOT = dirname(dirname(PLUGIN_ROOT));
+const OUT = join(REPO_ROOT, "dist", "opencode");
+const NAMES = ["export", "import", "sync"];
+// Runtime scripts shared by every skill (exclude this generator).
+const SCRIPTS = readdirSync(join(PLUGIN_ROOT, "scripts")).filter(
+  (f) => f.endsWith(".mjs") && f !== "build-dist.mjs",
+);
+
+// Naive frontmatter split — every source file uses single-line `key: value`.
+function parse(text) {
+  const m = text.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+  if (!m) throw new Error("missing frontmatter");
+  const fm = {};
+  for (const line of m[1].split("\n")) {
+    const i = line.indexOf(":");
+    if (i !== -1) fm[line.slice(0, i).trim()] = line.slice(i + 1).trim();
+  }
+  return { fm, body: m[2] };
+}
+
+const read = (...p) => readFileSync(join(PLUGIN_ROOT, ...p), "utf8");
+function write(rel, content) {
+  const abs = join(OUT, rel);
+  mkdirSync(dirname(abs), { recursive: true });
+  writeFileSync(abs, content);
+}
+// OpenCode resolves a skill's relative paths against the skill base dir it injects.
+const toOpencodePath = (s) => s.replace(/"\$\{CLAUDE_PLUGIN_ROOT\}\/scripts\//g, '"scripts/');
+const stripSelfPrefix = (s) => s.replace(/multica-tool:/g, "");
+
+rmSync(OUT, { recursive: true, force: true });
+
+for (const name of NAMES) {
+  // Skill: keep prose, rewrite script path, drop Claude-only allowed-tools, bundle scripts.
+  const skill = parse(read("skills", name, "SKILL.md"));
+  const fm = `---\nname: ${skill.fm.name}\ndescription: ${skill.fm.description}\n---\n`;
+  write(`skills/${name}/SKILL.md`, fm + toOpencodePath(skill.body));
+  for (const s of SCRIPTS) {
+    mkdirSync(join(OUT, "skills", name, "scripts"), { recursive: true });
+    copyFileSync(join(PLUGIN_ROOT, "scripts", s), join(OUT, "skills", name, "scripts", s));
+  }
+
+  // Command: description only; body invokes the local (unprefixed) skill name.
+  const cmd = parse(read("commands", `${name}.md`));
+  write(`commands/${name}.md`, `---\ndescription: ${stripSelfPrefix(cmd.fm.description)}\n---\n${stripSelfPrefix(cmd.body)}`);
+
+  // Agent: tools -> permission.bash; body unprefixed.
+  const agent = parse(read("agents", `${name}.md`));
+  const head = `---\ndescription: ${stripSelfPrefix(agent.fm.description)}\nmode: subagent\npermission:\n  bash: allow\n---\n`;
+  write(`agents/${name}.md`, head + stripSelfPrefix(agent.body));
+}
+
+// Self-check: outputs must carry no Claude-only path/env and must bundle scripts.
+for (const name of NAMES) {
+  const md = readFileSync(join(OUT, "skills", name, "SKILL.md"), "utf8");
+  if (md.includes("CLAUDE_PLUGIN_ROOT") || md.includes("plugins/multica-tool"))
+    throw new Error(`leaked Claude path in ${name}/SKILL.md`);
+  for (const s of SCRIPTS) readFileSync(join(OUT, "skills", name, "scripts", s)); // throws if missing
+}
+
+console.log(`Wrote OpenCode artifacts for [${NAMES.join(", ")}] to ${OUT}`);

package/plugins/multica-tool/scripts/lib.mjs

@@ -84,7 +84,7 @@ export function getAgent(cli, id) {
 
 export function getSquad(cli, id) {
   const s = cli.json(["squad", "get", id]);
-  return { id: s.id, name: s.name, description: s.description, leaderId: s.leader_id };
+  return { id: s.id, name: s.name, description: s.description, instructions: s.instructions, leaderId: s.leader_id };
 }
 
 export const getSquadMembers = (cli, id) =>

package/plugins/multica-tool/scripts/multica-export.mjs

@@ -1,4 +1,5 @@
 import * as nodeFs from "node:fs";
+import { dirname } from "node:path";
 import { slugify, getSkill, getAgent, getSquad, getSquadMembers, makeCli, realExec, requireAuth, resolveWorkspaceId } from "./lib.mjs";
 
 const nonEmpty = (v) => v && typeof v === "object" && Object.keys(v).length > 0;
@@ -24,7 +25,7 @@ export function buildManifest({ scope, sourceWorkspaceId, skills, agents, squad
     sourceWorkspaceId,
     skills: [...seenSkills.values()].map((s) => ({ name: s.name, dir: `skills/${slugify(s.name)}`, sourceId: s.sourceId })),
     agents: [...seenAgents.values()].map((a) => ({ name: a.name, file: `agents/${slugify(a.name)}.json`, sourceRuntimeId: a.sourceRuntimeId, skillNames: a.skillNames, hadSecrets: !!a.hadSecrets })),
-    squads: squad ? [{ name: squad.name, file: `squads/${slugify(squad.name)}.json`, description: squad.description ?? "", leaderName: squad.leaderName, members: squad.members }] : [],
+    squads: squad ? [{ name: squad.name, file: `squads/${slugify(squad.name)}.json`, description: squad.description ?? "", instructions: squad.instructions ?? "", leaderName: squad.leaderName, members: squad.members }] : [],
   };
 }
 
@@ -62,6 +63,7 @@ export function exportResource({ cli, scope, ids, outDir, sourceWorkspaceId, fs
     squad = {
       name: sq.name,
       description: sq.description,
+      instructions: sq.instructions,
       leaderName: nameOf(sq.leaderId),
       members: members.map((m) => ({ agentName: nameOf(m.memberId), role: m.role })),
     };
@@ -83,7 +85,11 @@ export function exportResource({ cli, scope, ids, outDir, sourceWorkspaceId, fs
     fs.mkdirSync(dir, { recursive: true });
     fs.writeFileSync(`${dir}/SKILL.md`, s.content ?? "");
     fs.writeFileSync(`${dir}/config.json`, JSON.stringify(s.config ?? {}, null, 2));
-    for (const f of s.files ?? []) fs.writeFileSync(`${dir}/${f.path}`, f.content ?? "");
+    for (const f of s.files ?? []) {
+      const target = `${dir}/${f.path}`;
+      fs.mkdirSync(dirname(target), { recursive: true }); // f.path may be nested, e.g. scripts/foo.sh
+      fs.writeFileSync(target, f.content ?? "");
+    }
   }
   // Index agent entries by name for the manifest writing loop.
   const agentByName = new Map([...agentsById.values()].map((a) => [a.raw.name, a]));

package/plugins/multica-tool/scripts/multica-import.mjs

@@ -1,5 +1,25 @@
 import * as nodeFs from "node:fs";
-import { listSkills, listAgents, listSquads, findByName, makeCli, realExec, requireAuth, resolveWorkspaceId } from "./lib.mjs";
+import { listSkills, listAgents, listSquads, getSquadMembers, findByName, makeCli, realExec, requireAuth, resolveWorkspaceId } from "./lib.mjs";
+
+// Relative paths of every file under root (recursing into subdirs like scripts/).
+function walkSkillFiles(fs, root, rel = "") {
+  const out = [];
+  for (const ent of fs.readdirSync(rel ? `${root}/${rel}` : root, { withFileTypes: true })) {
+    const r = rel ? `${rel}/${ent.name}` : ent.name;
+    if (ent.isDirectory()) out.push(...walkSkillFiles(fs, root, r));
+    else out.push(r);
+  }
+  return out;
+}
+
+// Pull `description:` out of a SKILL.md YAML frontmatter block.
+// ponytail: single-line values only (the skill frontmatter convention); folded/multi-line YAML not handled.
+function frontmatterDescription(text) {
+  const block = /^---\r?\n([\s\S]*?)\r?\n---/.exec(text);
+  if (!block) return "";
+  const line = block[1].split(/\r?\n/).find((l) => /^description\s*:/.test(l));
+  return line ? line.replace(/^description\s*:/, "").trim().replace(/^["']|["']$/g, "") : "";
+}
 
 export function importSkills({ cli, manifest, dir, fs = nodeFs }) {
   const idMap = new Map();
@@ -12,19 +32,24 @@ export function importSkills({ cli, manifest, dir, fs = nodeFs }) {
     const configPath = `${sdir}/config.json`;
     const config = fs.existsSync(configPath) ? fs.readFileSync(configPath, "utf8") : "{}";
     const match = findByName(existing, s.name);
+    // Fall back to the SKILL.md frontmatter description when the manifest carries none.
+    const fmDesc = frontmatterDescription(fs.readFileSync(contentPath, "utf8"));
     let id;
     if (match) {
-      cli.run(["skill", "update", match.id, "--content-file", contentPath, "--config", config]);
+      // Only fill description when the existing skill has none — don't clobber a set one.
+      const desc = !match.description && fmDesc ? ["--description", fmDesc] : [];
+      cli.run(["skill", "update", match.id, "--content-file", contentPath, "--config", config, ...desc]);
       id = match.id; updated++;
     } else {
-      const out = cli.run(["skill", "create", "--name", s.name, "--content-file", contentPath, "--config", config]);
+      const desc = fmDesc ? ["--description", fmDesc] : [];
+      const out = cli.run(["skill", "create", "--name", s.name, "--content-file", contentPath, "--config", config, ...desc]);
       id = JSON.parse(out).id; created++;
     }
     idMap.set(s.name, id);
-    // upsert extra files (everything except SKILL.md and config.json)
-    for (const f of fs.readdirSync(sdir)) {
-      if (f === "SKILL.md" || f === "config.json") continue;
-      cli.run(["skill", "files", "upsert", id, "--path", f, "--content-file", `${sdir}/${f}`]);
+    // upsert extra files (everything except SKILL.md and config.json), by relative path
+    for (const rel of walkSkillFiles(fs, sdir)) {
+      if (rel === "SKILL.md" || rel === "config.json") continue;
+      cli.run(["skill", "files", "upsert", id, "--path", rel, "--content-file", `${sdir}/${rel}`]);
     }
   }
   return { idMap, created, updated };
@@ -70,16 +95,21 @@ export function importSquad({ cli, squad, agentIdMap }) {
   const leaderId = agentIdMap.get(squad.leaderName);
   const match = findByName(existing, squad.name);
   let id, created = 0, updated = 0;
+  const instr = squad.instructions ? ["--instructions", squad.instructions] : [];
   if (match) {
-    cli.run(["squad", "update", match.id, "--leader", leaderId, "--description", squad.description ?? ""]);
+    cli.run(["squad", "update", match.id, "--leader", leaderId, "--description", squad.description ?? "", ...instr]);
     id = match.id; updated++;
   } else {
-    const out = cli.run(["squad", "create", "--name", squad.name, "--leader", leaderId, "--description", squad.description ?? ""]);
+    const out = cli.run(["squad", "create", "--name", squad.name, "--leader", leaderId, "--description", squad.description ?? "", ...instr]);
     id = JSON.parse(out).id; created++;
   }
+  // Add non-leader members, skipping any already present so re-runs are idempotent.
+  const present = new Set(getSquadMembers(cli, id).map((m) => m.memberId));
   for (const m of squad.members) {
     if (m.agentName === squad.leaderName) continue;
-    cli.run(["squad", "member", "add", id, "--member-id", agentIdMap.get(m.agentName), "--role", m.role, "--type", "agent"]);
+    const memberId = agentIdMap.get(m.agentName);
+    if (present.has(memberId)) continue;
+    cli.run(["squad", "member", "add", id, "--member-id", memberId, "--role", m.role, "--type", "agent"]);
   }
   return { newId: id, created, updated };
 }

package/plugins/multica-tool/skills/export/SKILL.md

@@ -13,7 +13,7 @@ Export a Multica resource (skill, agent, or squad) to a local bundle directory.
 Run the export script; it calls `multica auth status` internally and exits with an error message if unauthenticated:
 
 ```bash
-node plugins/multica-tool/scripts/multica-export.mjs --help 2>&1 || true
+node "${CLAUDE_PLUGIN_ROOT}/scripts/multica-export.mjs" --help 2>&1 || true
 ```
 
 If `multica login` is required, surface that message verbatim and stop.
@@ -43,7 +43,7 @@ where `<slug>` is a lowercased, hyphenated form of the resource name.
 ## Step 4 — Run the export
 
 ```bash
-node plugins/multica-tool/scripts/multica-export.mjs \
+node "${CLAUDE_PLUGIN_ROOT}/scripts/multica-export.mjs" \
   --scope <type> \
   --id <id> \
   --out <dir> \

package/plugins/multica-tool/skills/import/SKILL.md

@@ -33,7 +33,7 @@ For each distinct `sourceRuntimeId`, ask the user to pick a matching target runt
 ## Step 3 — Run the import
 
 ```bash
-node plugins/multica-tool/scripts/multica-import.mjs \
+node "${CLAUDE_PLUGIN_ROOT}/scripts/multica-import.mjs" \
   --dir <folder> \
   --workspace <workspace-name> \
   --runtime-map <srcId1=dstId1,srcId2=dstId2,...>

package/plugins/multica-tool/skills/sync/SKILL.md

@@ -33,7 +33,7 @@ For skills (which have no runtime dependency), an empty runtime map is acceptabl
 ## Step 3 — Run the sync
 
 ```bash
-node plugins/multica-tool/scripts/multica-sync.mjs \
+node "${CLAUDE_PLUGIN_ROOT}/scripts/multica-sync.mjs" \
   <type> <name> from <src-ws> <dest-ws> \
   [--runtime-map <srcId1=dstId1,srcId2=dstId2,...>]
 ```

package/plugins/plugin-validator/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "plugin-validator",
   "displayName": "Plugin Validator",
-  "version": "0.0.32",
+  "version": "0.0.34",
   "description": "Orchestrated validator for Claude Code plugins — validates skills, agents, commands, and hooks across every plugin under plugins/**.",
   "author": {
     "name": "Steven Hoang"

package/plugins/team-share/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "team-share",
   "displayName": "Team Share",
-  "version": "0.0.32",
+  "version": "0.0.34",
   "description": "Onboard your team with an interactive setup menu: install CodeGraph, build the Understand-Anything knowledge graph, and share Claude Code settings — run any combination, all idempotent.",
   "author": {
     "name": "Steven Hoang"

package/plugins/tech-graph/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "tech-graph",
-  "version": "0.0.32",
+  "version": "0.0.34",
   "description": "Step-by-step wizard for generating technical diagrams as SVG+PNG.",
   "author": {
     "name": "steven"