@drunkcoding/agents-and-skills 0.0.33 → 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.33",
+      "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.33",
+      "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.33",
+      "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.33",
+      "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.33",
+      "version": "0.0.34",
       "category": "workflow",
       "keywords": [
         "multica",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drunkcoding/agents-and-skills",
-  "version": "0.0.33",
+  "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.33",
+  "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.33",
+  "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/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/plugin-validator/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "plugin-validator",
   "displayName": "Plugin Validator",
-  "version": "0.0.33",
+  "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.33",
+  "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.33",
+  "version": "0.0.34",
   "description": "Step-by-step wizard for generating technical diagrams as SVG+PNG.",
   "author": {
     "name": "steven"