skilld 1.7.3 → 2.0.0

package/dist/_chunks/add.mjs

@@ -0,0 +1,66 @@
+import { n as COMMA_OR_WHITESPACE_RE } from "./regex.mjs";
+import { l as hasCompletedWizard } from "./cache.mjs";
+import { t as autoResolveAgent } from "./agent-prompt.mjs";
+import { t as sharedArgs } from "./args.mjs";
+import { s as parseSkillInput } from "./semver.mjs";
+import { t as runWizard } from "./wizard2.mjs";
+import { t as installSkills } from "./install-many.mjs";
+import { t as exportPortablePrompts } from "./portable.mjs";
+import * as p from "@clack/prompts";
+import { defineCommand } from "citty";
+const addCommandDef = defineCommand({
+	meta: {
+		name: "add",
+		description: "Install skills (npm:<pkg>, crate:<name>, gh:<owner/repo>, @<curator>)"
+	},
+	args: {
+		"package": {
+			type: "positional",
+			description: "Package(s) to sync (space/comma-separated; npm:<pkg>, crate:<name>, or owner/repo)",
+			required: true
+		},
+		"skill": {
+			type: "string",
+			alias: "s",
+			description: "Select specific skills from a git repo (comma-separated)",
+			valueHint: "name"
+		},
+		"allow-unsafe": {
+			type: "boolean",
+			description: "Install skills that fail the upstream audit gate"
+		},
+		...sharedArgs
+	},
+	async run({ args }) {
+		const rawInputs = [...new Set([args.package, ...args._ || []].map((s) => s.trim()).filter(Boolean))];
+		if (args.agent === "none") {
+			const packages = [...new Set(rawInputs.flatMap((s) => s.split(COMMA_OR_WHITESPACE_RE)).map((s) => s.trim()).filter(Boolean))];
+			for (const pkg of packages) await exportPortablePrompts(pkg, {
+				force: args.force,
+				agent: "none"
+			});
+			return;
+		}
+		const agent = autoResolveAgent(args.agent);
+		if (!agent) {
+			p.log.error("No target agent detected.\n  Pass --agent <name> (claude-code, cursor, codex, …) or run `skilld config` to set a default.\n  Use --agent none for portable export.");
+			process.exitCode = 1;
+			return;
+		}
+		if (!hasCompletedWizard()) await runWizard({ agent });
+		await installSkills(rawInputs.map(parseSkillInput), {
+			agent,
+			surface: "cli:add",
+			global: args.global,
+			yes: args.yes,
+			force: args.force,
+			debug: args.debug,
+			model: args.model,
+			skillFilter: args.skill,
+			allowUnsafe: args["allow-unsafe"]
+		});
+	}
+});
+export { addCommandDef };
+
+//# sourceMappingURL=add.mjs.map

package/dist/_chunks/add.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.mjs","names":[],"sources":["../../src/commands/sync/add.ts"],"sourcesContent":["import type { AgentType, OptimizeModel } from '../../agent/index.ts'\nimport * as p from '@clack/prompts'\nimport { defineCommand } from 'citty'\nimport { autoResolveAgent } from '../../cli/agent-prompt.ts'\nimport { sharedArgs } from '../../cli/args.ts'\nimport { hasCompletedWizard } from '../../core/config.ts'\nimport { parseSkillInput } from '../../core/prefix.ts'\nimport { COMMA_OR_WHITESPACE_RE } from '../../core/regex.ts'\nimport { runWizard } from '../wizard.ts'\nimport { installSkills } from './install-many.ts'\nimport { exportPortablePrompts } from './portable.ts'\n\nexport const addCommandDef = defineCommand({\n  meta: { name: 'add', description: 'Install skills (npm:<pkg>, crate:<name>, gh:<owner/repo>, @<curator>)' },\n  args: {\n    'package': {\n      type: 'positional',\n      description: 'Package(s) to sync (space/comma-separated; npm:<pkg>, crate:<name>, or owner/repo)',\n      required: true,\n    },\n    'skill': {\n      type: 'string',\n      alias: 's',\n      description: 'Select specific skills from a git repo (comma-separated)',\n      valueHint: 'name',\n    },\n    'allow-unsafe': {\n      type: 'boolean',\n      description: 'Install skills that fail the upstream audit gate',\n    },\n    ...sharedArgs,\n  },\n  async run({ args }) {\n    const rawInputs = [...new Set(\n      [args.package, ...((args as any)._ || [])]\n        .map((s: string) => s.trim())\n        .filter(Boolean),\n    )]\n\n    // --agent none → portable export (no installed-agent target needed).\n    if (args.agent === 'none') {\n      const packages = [...new Set(rawInputs.flatMap(s => s.split(COMMA_OR_WHITESPACE_RE)).map(s => s.trim()).filter(Boolean))]\n      for (const pkg of packages)\n        await exportPortablePrompts(pkg, { force: args.force, agent: 'none' })\n      return\n    }\n\n    const agent: AgentType | null = autoResolveAgent(args.agent)\n    if (!agent) {\n      p.log.error('No target agent detected.\\n  Pass --agent <name> (claude-code, cursor, codex, …) or run `skilld config` to set a default.\\n  Use --agent none for portable export.')\n      process.exitCode = 1\n      return\n    }\n\n    if (!hasCompletedWizard())\n      await runWizard({ agent })\n\n    const items = rawInputs.map(parseSkillInput)\n    await installSkills(items, {\n      agent,\n      surface: 'cli:add',\n      global: args.global,\n      yes: args.yes,\n      force: args.force,\n      debug: args.debug,\n      model: args.model as OptimizeModel | undefined,\n      skillFilter: args.skill,\n      allowUnsafe: args['allow-unsafe'],\n    })\n  },\n})\n"],"mappings":";;;;;;;;;;AAYA,MAAa,gBAAgB,cAAc;CACzC,MAAM;EAAE,MAAM;EAAO,aAAa;EAAyE;CAC3G,MAAM;EACJ,WAAW;GACT,MAAM;GACN,aAAa;GACb,UAAU;GACX;EACD,SAAS;GACP,MAAM;GACN,OAAO;GACP,aAAa;GACb,WAAW;GACZ;EACD,gBAAgB;GACd,MAAM;GACN,aAAa;GACd;EACD,GAAG;EACJ;CACD,MAAM,IAAI,EAAE,QAAQ;EAClB,MAAM,YAAY,CAAC,GAAG,IAAI,IACxB,CAAC,KAAK,SAAS,GAAK,KAAa,KAAK,EAAE,CAAE,CACvC,KAAK,MAAc,EAAE,MAAM,CAAC,CAC5B,OAAO,QAAQ,CACnB,CAAC;EAGF,IAAI,KAAK,UAAU,QAAQ;GACzB,MAAM,WAAW,CAAC,GAAG,IAAI,IAAI,UAAU,SAAQ,MAAK,EAAE,MAAM,uBAAuB,CAAC,CAAC,KAAI,MAAK,EAAE,MAAM,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC;GACzH,KAAK,MAAM,OAAO,UAChB,MAAM,sBAAsB,KAAK;IAAE,OAAO,KAAK;IAAO,OAAO;IAAQ,CAAC;GACxE;;EAGF,MAAM,QAA0B,iBAAiB,KAAK,MAAM;EAC5D,IAAI,CAAC,OAAO;GACV,EAAE,IAAI,MAAM,qKAAqK;GACjL,QAAQ,WAAW;GACnB;;EAGF,IAAI,CAAC,oBAAoB,EACvB,MAAM,UAAU,EAAE,OAAO,CAAC;EAG5B,MAAM,cADQ,UAAU,IAAI,gBACH,EAAE;GACzB;GACA,SAAS;GACT,QAAQ,KAAK;GACb,KAAK,KAAK;GACV,OAAO,KAAK;GACZ,OAAO,KAAK;GACZ,OAAO,KAAK;GACZ,aAAa,KAAK;GAClB,aAAa,KAAK;GACnB,CAAC;;CAEL,CAAC"}

package/dist/_chunks/agent-prompt.mjs

@@ -0,0 +1,88 @@
+import { a as targets, n as detectProjectAgents, r as detectTargetAgent, t as detectInstalledAgents } from "./detect.mjs";
+import "./agent.mjs";
+import { d as readConfig, m as updateConfig } from "./cache.mjs";
+import { t as isInteractive } from "./env.mjs";
+import { styleText } from "node:util";
+import * as p from "@clack/prompts";
+function resolveAgent(agentFlag) {
+	if (process.env.SKILLD_NO_AGENT) return null;
+	return agentFlag ?? detectTargetAgent() ?? readConfig().agent ?? null;
+}
+function autoResolveAgent(agentFlag) {
+	const resolved = resolveAgent(agentFlag);
+	if (resolved && resolved !== "none") return resolved;
+	if (process.env.SKILLD_NO_AGENT) return null;
+	const projectMatches = detectProjectAgents();
+	if (projectMatches.length === 1) return projectMatches[0];
+	const installed = detectInstalledAgents();
+	if (installed.length === 1) return installed[0];
+	return null;
+}
+let _warnedNoAgent = false;
+function warnNoAgent() {
+	if (_warnedNoAgent) return;
+	_warnedNoAgent = true;
+	p.log.warn("No target agent detected — falling back to prompt-only mode.\n  Use --agent <name> to specify, or run `skilld config` to set a default.");
+}
+async function promptForAgent() {
+	const noAgent = !!process.env.SKILLD_NO_AGENT;
+	const installed = noAgent ? [] : detectInstalledAgents();
+	const projectMatches = noAgent ? [] : detectProjectAgents();
+	if (!isInteractive()) {
+		if (installed.length === 1) {
+			updateConfig({ agent: installed[0] });
+			return installed[0];
+		}
+		warnNoAgent();
+		return "none";
+	}
+	p.log.info("Skilld generates reference cards from package docs so your AI agent\n  always has accurate APIs for your exact dependency versions.");
+	const candidateIds = projectMatches.length > 0 ? projectMatches : installed.length > 0 ? installed : Object.keys(targets);
+	const sharedAgents = new Set(Object.entries(targets).filter(([, a]) => a.additionalSkillsDirs.some((d) => d.includes(".claude/skills"))).map(([id]) => id));
+	const sharedIds = candidateIds.filter((id) => id === "claude-code" || sharedAgents.has(id));
+	const isolatedIds = candidateIds.filter((id) => id !== "claude-code" && !sharedAgents.has(id));
+	const options = [];
+	if (sharedIds.length > 0 && isolatedIds.length > 0) for (const id of sharedIds) {
+		const a = targets[id];
+		const hint = id === "claude-code" ? `skills shared with ${sharedIds.length - 1} other agents` : `skills shared with Claude Code and others`;
+		options.push({
+			label: a.displayName,
+			value: id,
+			hint
+		});
+	}
+	const isolatedAgentIds = new Set(Object.entries(targets).filter(([, a]) => a.additionalSkillsDirs.length === 0).map(([id]) => id));
+	for (const id of sharedIds.length > 0 && isolatedIds.length > 0 ? isolatedIds : candidateIds) {
+		if (options.some((o) => o.value === id)) continue;
+		const a = targets[id];
+		const hint = sharedAgents.has(id) && id !== "claude-code" ? "skills shared with Claude Code and others" : isolatedAgentIds.has(id) ? "skills only visible to this agent" : void 0;
+		options.push({
+			label: a.displayName,
+			value: id,
+			hint
+		});
+	}
+	options.push({
+		label: "No agent",
+		value: "none",
+		hint: "export as standalone files for any AI"
+	});
+	if (!_warnedNoAgent) {
+		_warnedNoAgent = true;
+		const hint = projectMatches.length > 1 ? `Multiple agent directories found: ${projectMatches.map((t) => targets[t].displayName).join(", ")}` : installed.length > 0 ? `Found ${installed.map((t) => targets[t].displayName).join(", ")} but couldn't determine which to use` : "No agents auto-detected";
+		const crossNote = sharedIds.length > 1 ? `\n  ${styleText("gray", `Tip: Picking Claude Code shares skills with ${sharedIds.filter((id) => id !== "claude-code").map((id) => targets[id].displayName).join(", ")} automatically.`)}` : "";
+		p.log.warn(`${hint}\n  Pick the agent you actively code with.${crossNote}`);
+	}
+	const choice = await p.select({
+		message: "Which AI coding agent do you use?",
+		options
+	});
+	if (p.isCancel(choice)) return null;
+	if (choice === "none") return "none";
+	updateConfig({ agent: choice });
+	p.log.success(`Target agent set to ${targets[choice].displayName}`);
+	return choice;
+}
+export { promptForAgent as n, resolveAgent as r, autoResolveAgent as t };
+
+//# sourceMappingURL=agent-prompt.mjs.map

package/dist/_chunks/agent-prompt.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-prompt.mjs","names":["agents"],"sources":["../../src/cli/agent-prompt.ts"],"sourcesContent":["import type { AgentType } from '../agent/index.ts'\nimport { styleText } from 'node:util'\nimport * as p from '@clack/prompts'\nimport { agents, detectInstalledAgents, detectProjectAgents, detectTargetAgent } from '../agent/index.ts'\nimport { readConfig, updateConfig } from '../core/config.ts'\nimport { isInteractive } from './env.ts'\n\nexport function resolveAgent(agentFlag?: string): AgentType | 'none' | null {\n  if (process.env.SKILLD_NO_AGENT)\n    return null\n  return (agentFlag as AgentType | undefined)\n    ?? detectTargetAgent()\n    ?? (readConfig().agent as AgentType | undefined)\n    ?? null\n}\n\n/**\n * Auto-resolve target agent without prompting. Consults, in order:\n *   1. Explicit `--agent` flag.\n *   2. Env-detected target (`CLAUDE_CODE`, `CURSOR_SESSION`, etc).\n *   3. Saved config default.\n *   4. Project marker dirs (`.claude/skills`, `.cursor/`, …) when exactly one\n *      agent matches the cwd.\n *   5. Installed agents on the machine when exactly one is found.\n *\n * Returns `null` when nothing is determined. Callers should error with a clear\n * \"pass --agent <name>\" hint rather than prompting — keeps commands\n * scriptable.\n */\nexport function autoResolveAgent(agentFlag?: string): AgentType | null {\n  const resolved = resolveAgent(agentFlag)\n  if (resolved && resolved !== 'none')\n    return resolved\n\n  if (process.env.SKILLD_NO_AGENT)\n    return null\n\n  const projectMatches = detectProjectAgents()\n  if (projectMatches.length === 1)\n    return projectMatches[0]!\n\n  const installed = detectInstalledAgents()\n  if (installed.length === 1)\n    return installed[0]!\n\n  return null\n}\n\nexport function listKnownAgents(): AgentType[] {\n  return Object.keys(agents) as AgentType[]\n}\n\nlet _warnedNoAgent = false\nfunction warnNoAgent(): void {\n  if (_warnedNoAgent)\n    return\n  _warnedNoAgent = true\n  p.log.warn('No target agent detected — falling back to prompt-only mode.\\n  Use --agent <name> to specify, or run `skilld config` to set a default.')\n}\n\nexport async function promptForAgent(): Promise<AgentType | 'none' | null> {\n  const noAgent = !!process.env.SKILLD_NO_AGENT\n  const installed = noAgent ? [] : detectInstalledAgents()\n  const projectMatches = noAgent ? [] : detectProjectAgents()\n\n  if (!isInteractive()) {\n    if (installed.length === 1) {\n      updateConfig({ agent: installed[0] })\n      return installed[0]!\n    }\n    warnNoAgent()\n    return 'none'\n  }\n\n  p.log.info(\n    `Skilld generates reference cards from package docs so your AI agent\\n`\n    + `  always has accurate APIs for your exact dependency versions.`,\n  )\n\n  const candidateIds = projectMatches.length > 0\n    ? projectMatches\n    : installed.length > 0\n      ? installed\n      : Object.keys(agents) as AgentType[]\n\n  const sharedAgents = new Set(\n    Object.entries(agents)\n      .filter(([, a]) => a.additionalSkillsDirs.some(d => d.includes('.claude/skills')))\n      .map(([id]) => id),\n  )\n\n  const sharedIds = candidateIds.filter(id => id === 'claude-code' || sharedAgents.has(id))\n  const isolatedIds = candidateIds.filter(id => id !== 'claude-code' && !sharedAgents.has(id))\n\n  const options: Array<{ label: string, value: AgentType | 'none', hint?: string }> = []\n\n  if (sharedIds.length > 0 && isolatedIds.length > 0) {\n    for (const id of sharedIds) {\n      const a = agents[id]\n      const hint = id === 'claude-code'\n        ? `skills shared with ${sharedIds.length - 1} other agents`\n        : `skills shared with Claude Code and others`\n      options.push({ label: a.displayName, value: id as AgentType, hint })\n    }\n  }\n\n  const isolatedAgentIds = new Set(\n    Object.entries(agents)\n      .filter(([, a]) => a.additionalSkillsDirs.length === 0)\n      .map(([id]) => id),\n  )\n\n  for (const id of (sharedIds.length > 0 && isolatedIds.length > 0 ? isolatedIds : candidateIds)) {\n    if (options.some(o => o.value === id))\n      continue\n    const a = agents[id]\n    const hint = sharedAgents.has(id) && id !== 'claude-code'\n      ? 'skills shared with Claude Code and others'\n      : isolatedAgentIds.has(id)\n        ? 'skills only visible to this agent'\n        : undefined\n    options.push({ label: a.displayName, value: id as AgentType, hint })\n  }\n\n  options.push({ label: 'No agent', value: 'none', hint: 'export as standalone files for any AI' })\n\n  if (!_warnedNoAgent) {\n    _warnedNoAgent = true\n    const hint = projectMatches.length > 1\n      ? `Multiple agent directories found: ${projectMatches.map(t => agents[t].displayName).join(', ')}`\n      : installed.length > 0\n        ? `Found ${installed.map(t => agents[t].displayName).join(', ')} but couldn't determine which to use`\n        : 'No agents auto-detected'\n    const crossNote = sharedIds.length > 1\n      ? `\\n  ${styleText('gray', `Tip: Picking Claude Code shares skills with ${sharedIds.filter(id => id !== 'claude-code').map(id => agents[id].displayName).join(', ')} automatically.`)}`\n      : ''\n    p.log.warn(`${hint}\\n  Pick the agent you actively code with.${crossNote}`)\n  }\n\n  const choice = await p.select({\n    message: 'Which AI coding agent do you use?',\n    options,\n  })\n\n  if (p.isCancel(choice))\n    return null\n\n  if (choice === 'none')\n    return 'none'\n\n  updateConfig({ agent: choice })\n  p.log.success(`Target agent set to ${agents[choice].displayName}`)\n  return choice\n}\n"],"mappings":";;;;;;AAOA,SAAgB,aAAa,WAA+C;CAC1E,IAAI,QAAQ,IAAI,iBACd,OAAO;CACT,OAAQ,aACH,mBAAmB,IAClB,YAAY,CAAC,SACd;;;;;;;;;;;;;;CAgBP,IAAA,gBAAgB;CACd,iBAAiB;CACjB,EAAA,IAAI,KAAA,0IACK;;eAKH,iBAAiB;CACvB,MAAI,UAAA,CAAA,CAAA,QAAe,IAAW;CAG9B,MAAM,YAAY,UAAA,EAAA,GAAA,uBAAuB;CACzC,MAAI,iBAAU,UACZ,EAAO,GAAA,qBAAU;CAEnB,IAAA,CAAA,eAAO,EAAA;;GAOT,aAAI,EAAA,OAAiB,UAAA,IAAA,CAAA;GACrB,OAAS,UAAA;;EAGP,aAAA;EACA,OAAM;;CAGR,EAAA,IAAA,KAAA,sIAA2E;CACzE,MAAM,eAAY,eAAY,SAAA,IAAA,iBAAA,UAAA,SAAA,IAAA,YAAA,OAAA,KAAA,QAAA;CAC9B,MAAM,eAAY,IAAA,IAAU,OAAK,QAAA,QAAA,CAAA,QAAuB,GAAA,OAAA,EAAA,qBAAA,MAAA,MAAA,EAAA,SAAA,iBAAA,CAAA,CAAA,CAAA,KAAA,CAAA,QAAA,GAAA,CAAA;CACxD,MAAM,YAAA,aAAiB,QAAe,OAAA,OAAA,iBAAqB,aAAA,IAAA,GAAA,CAAA;CAE3D,MAAK,cAAe,aAAE,QAAA,OAAA,OAAA,iBAAA,CAAA,aAAA,IAAA,GAAA,CAAA;OAChB,UAAU,EAAA;KACZ,UAAA,SAAe,KAAO,YAAe,SAAA,GAAA,KAAA,MAAA,MAAA,WAAA;QACrC,IAAO,QAAU;;EAEnB,QAAA,KAAa;GACb,OAAO,EAAA;;GAGP;GAKF,CAAA;;CAYA,MAAM,mBAAY,IAAA,IAAa,OAAO,QAAM,QAAO,CAAA,QAAA,GAAA,OAAiB,EAAA,qBAAqB,WAAA,EAAA,CAAA,KAAA,CAAA,QAAA,GAAA,CAAA;CACzF,KAAA,MAAM,MAAA,UAAc,SAAa,KAAO,YAAM,SAAO,IAAA,cAAkB,cAAqB;EAE5F,IAAA,QAAM,MAAgF,MAAA,EAAA,UAAA,GAAA,EAAA;EAEtF,MAAI,IAAA,QAAU;EAEV,MAAM,OAAIA,aAAO,IAAA,GAAA,IAAA,OAAA,gBAAA,8CAAA,iBAAA,IAAA,GAAA,GAAA,sCAAA,KAAA;EACjB,QAAM,KAAO;GAGb,OAAQ,EAAA;GAAO,OAAO;GAAe;GAAwB,CAAA;;;EAIjE,OAAM;EAMN,OAAK;EACH,MAAI;EAEJ,CAAA;KACA,CAAA,gBAAa;EAKb,iBAAa;QAAE,OAAS,eAAA,SAAA,IAAA,qCAAA,eAAA,KAAA,MAAA,QAAA,GAAA,YAAA,CAAA,KAAA,KAAA,KAAA,UAAA,SAAA,IAAA,SAAA,UAAA,KAAA,MAAA,QAAA,GAAA,YAAA,CAAA,KAAA,KAAA,CAAA,wCAAA;QAAa,YAAO,UAAA,SAAA,IAAA,OAAA,UAAA,QAAA,+CAAA,UAAA,QAAA,OAAA,OAAA,cAAA,CAAA,KAAA,OAAA,QAAA,IAAA,YAAA,CAAA,KAAA,KAAA,CAAA,iBAAA,KAAA;IAAiB,IAAA,KAAA,GAAA,KAAA,4CAAA,YAAA;;;EAG/D,SAAQ;EAAO;EAAmB,CAAA;KAAe,EAAA,SAAM,OAAA,EAAA,OAAA;KAA0C,WAAA,QAAA,OAAA;CAEjG,aAAK,EAAA,OAAgB,QAAA,CAAA;GACnB,IAAA,QAAA,uBAAiB,QAAA,QAAA,cAAA;QACX"}