skilld 1.7.3 → 2.0.0

package/dist/_chunks/wizard2.mjs

@@ -0,0 +1,200 @@
+import { a as targets } from "./detect.mjs";
+import { a as getModelName, c as getOAuthProviderList, l as loginOAuthProvider, r as getAvailableModels } from "./agent.mjs";
+import { m as updateConfig, o as defaultFeatures } from "./cache.mjs";
+import { t as isInteractive } from "./env.mjs";
+import { r as resolveAgent } from "./agent-prompt.mjs";
+import { t as sharedArgs } from "./args.mjs";
+import { n as OAUTH_NOTE, r as pickModel, t as NO_MODELS_MESSAGE } from "./model-picker.mjs";
+import { styleText } from "node:util";
+import * as p from "@clack/prompts";
+import { defineCommand } from "citty";
+import { execSync } from "node:child_process";
+function hasGhCli() {
+	if (process.env.SKILLD_NO_GH) return false;
+	try {
+		execSync("gh --version", { stdio: "ignore" });
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function runWizard(opts = {}) {
+	if (!isInteractive()) return false;
+	const agentLabel = opts.agent ? targets[opts.agent].displayName : null;
+	const skillsDir = opts.agent ? targets[opts.agent].skillsDir : ".claude/skills";
+	const agentLine = agentLabel ? `\n${styleText("gray", `Target agent: ${agentLabel}`)}` : "";
+	p.note(`Your AI agent reads docs from its training data - but APIs change,
+versions drift, and patterns go stale. Skilld fixes this.
+
+It generates a ${styleText("bold", "SKILL.md")} - a markdown reference card built from\nthe ${styleText("bold", "actual docs, issues, and release notes")} for the exact\npackage versions in your project. Your agent reads this file\nevery session - no hallucinated APIs.\n\n${styleText("bold", "How it works:")}\n  1. Fetch docs, issues, and types for your packages\n  2. Optionally compress with an LLM into a concise cheat sheet\n\n${styleText("gray", `Example: \`skilld add vue\` creates ${skillsDir}/vue-skilld/SKILL.md\nYour agent then knows the right APIs, gotchas, and patterns\nfor your exact version.`)}${agentLine}`, "Welcome to skilld");
+	const ghInstalled = hasGhCli();
+	if (ghInstalled) p.log.success("GitHub CLI detected — will use it to pull issues and discussions.");
+	else p.log.info(`${styleText("gray", "GitHub CLI not installed — issues and discussions disabled.")}\n  Install later to enable: ${styleText("cyan", "https://cli.github.com")}`);
+	const selected = await p.multiselect({
+		message: "What data sources should skills include?",
+		options: [
+			{
+				label: "Local search",
+				value: "search",
+				hint: "query engine for `skilld search` across all skill docs"
+			},
+			{
+				label: "Release notes",
+				value: "releases",
+				hint: "changelogs and migration notes per version"
+			},
+			{
+				label: "GitHub issues",
+				value: "issues",
+				hint: "common bugs, workarounds, and solutions",
+				disabled: !ghInstalled
+			},
+			{
+				label: "GitHub discussions",
+				value: "discussions",
+				hint: "community Q&A and usage examples",
+				disabled: !ghInstalled
+			}
+		],
+		initialValues: [...Object.entries(defaultFeatures).filter(([, v]) => v).map(([k]) => k), ...ghInstalled ? ["issues", "discussions"] : []],
+		required: false
+	});
+	if (p.isCancel(selected)) {
+		p.cancel("Setup cancelled");
+		return false;
+	}
+	const features = {
+		search: selected.includes("search"),
+		issues: selected.includes("issues"),
+		discussions: selected.includes("discussions"),
+		releases: selected.includes("releases")
+	};
+	p.note(`An LLM can optionally summarize raw docs into a focused reference
+highlighting best practices, gotchas, and migrations.
+
+${styleText("bold", "Without LLM:")}  ~2 KB skill with package metadata, types, and links\n${styleText("bold", "With LLM:")}     ~5 KB skill with curated gotchas, patterns, and migration notes\n\n${styleText("bold", "This is a one-time build step")} - it generates the SKILL.md, then your\ncoding agent reads the result every session. Can be a different model.\n\n${styleText("gray", "Works with API keys (ANTHROPIC_API_KEY, GEMINI_API_KEY, OPENAI_API_KEY)\nor CLI tools (claude, gemini, codex).")}`, "Enhancement model (optional)");
+	let modelId;
+	let skippedEnhancement = false;
+	let oauthJustConnected = false;
+	while (true) {
+		const allModels = process.env.SKILLD_NO_AGENTS ? [] : await getAvailableModels();
+		if (allModels.length === 0) p.log.warn(NO_MODELS_MESSAGE);
+		else if (oauthJustConnected) p.log.step(`${allModels.length} models now available. Select one below.`);
+		else {
+			const providers = /* @__PURE__ */ new Set();
+			for (const m of allModels) {
+				const vendor = m.vendorGroup ?? m.providerName;
+				if (!m.id.startsWith("pi:")) providers.add(`${vendor} via CLI`);
+				else if (m.hint?.includes("API key")) providers.add(`${vendor} via API key`);
+				else if (m.hint?.includes("OAuth")) providers.add(`${vendor} via OAuth`);
+			}
+			if (providers.size > 0) p.log.success(`Found: ${[...providers].join(", ")}`);
+		}
+		const afterOptions = getOAuthProviderList().length > 0 ? [{
+			label: "⚠ Connect OAuth provider...",
+			value: "_connect",
+			hint: "may violate provider ToS"
+		}, {
+			label: "Skip enhancement",
+			value: "_skip",
+			hint: "base skill with docs, issues, and types, add LLM later via `skilld config`"
+		}] : [{
+			label: "Skip enhancement",
+			value: "_skip",
+			hint: "base skill with docs, issues, and types, add LLM later via `skilld config`"
+		}];
+		const choice = await pickModel(allModels, {
+			before: allModels.length > 0 ? [{
+				label: "Auto",
+				value: "_auto",
+				hint: "picks best available model from connected providers"
+			}] : [],
+			after: afterOptions
+		});
+		if (choice === null) {
+			p.cancel("Setup cancelled");
+			return false;
+		}
+		if (choice === "_connect") {
+			await wizardConnectProvider();
+			oauthJustConnected = true;
+			continue;
+		}
+		if (choice === "_skip") {
+			skippedEnhancement = true;
+			break;
+		}
+		if (choice === "_auto") break;
+		modelId = choice;
+		break;
+	}
+	updateConfig({
+		features,
+		...modelId ? {
+			model: modelId,
+			skipLlm: false
+		} : {
+			model: void 0,
+			skipLlm: skippedEnhancement
+		}
+	});
+	const modelSummary = modelId ? getModelName(modelId) : skippedEnhancement ? "none (raw docs)" : "auto";
+	const featureList = Object.entries(features).filter(([, v]) => v).map(([k]) => k).join(", ") || "none";
+	p.log.success(`Model: ${modelSummary} · Features: ${featureList}`);
+	if (opts.showOutro !== false) p.note(`Run ${styleText("cyan", "skilld add <pkg>")} to generate skills for specific packages\nRun ${styleText("cyan", "skilld")} to scan your project and pick packages interactively\nRun ${styleText("cyan", "skilld config")} to change settings later`, "Setup complete");
+	return true;
+}
+async function wizardConnectProvider() {
+	p.note(OAUTH_NOTE, "How OAuth works");
+	const providers = getOAuthProviderList();
+	const provider = await p.select({
+		message: "Connect provider",
+		options: providers.map((pr) => ({
+			label: pr.name,
+			value: pr.id,
+			hint: pr.loggedIn ? "connected" : void 0
+		}))
+	});
+	if (p.isCancel(provider)) return;
+	const spinner = p.spinner();
+	spinner.start("Connecting...");
+	const success = await loginOAuthProvider(provider, {
+		onAuth: (url, instructions) => {
+			spinner.stop("Open this URL in your browser:");
+			p.log.info(`  ${styleText("cyan", url)}`);
+			if (instructions) p.log.info(`  ${styleText("gray", instructions)}`);
+			spinner.start("Waiting for authentication...");
+		},
+		onPrompt: async (message, placeholder) => {
+			const value = await p.text({
+				message,
+				placeholder
+			});
+			if (p.isCancel(value)) return "";
+			return value;
+		},
+		onProgress: (msg) => p.log.step(msg)
+	}).catch((err) => {
+		spinner.stop(`Login failed: ${err.message}`);
+		return false;
+	});
+	spinner.stop();
+	if (success) {
+		const name = providers.find((pr) => pr.id === provider)?.name ?? provider;
+		p.log.success(`Connected to ${name}`);
+	}
+}
+const setupCommandDef = defineCommand({
+	meta: {
+		name: "setup",
+		description: "Re-run the setup wizard to configure features and model"
+	},
+	args: { agent: sharedArgs.agent },
+	async run({ args }) {
+		const agent = resolveAgent(args.agent);
+		await runWizard({ agent: agent && agent !== "none" ? agent : void 0 });
+	}
+});
+export { setupCommandDef as n, runWizard as t };
+
+//# sourceMappingURL=wizard2.mjs.map

package/dist/_chunks/wizard2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard2.mjs","names":["agents"],"sources":["../../src/commands/wizard.ts"],"sourcesContent":["import type { AgentType, OptimizeModel } from '../agent/index.ts'\nimport type { FeaturesConfig } from '../core/config.ts'\nimport { execSync } from 'node:child_process'\nimport { styleText } from 'node:util'\nimport * as p from '@clack/prompts'\nimport { defineCommand } from 'citty'\nimport { getOAuthProviderList, loginOAuthProvider } from '../agent/clis/pi-ai.ts'\nimport { agents, getAvailableModels, getModelName } from '../agent/index.ts'\nimport { resolveAgent } from '../cli/agent-prompt.ts'\nimport { sharedArgs } from '../cli/args.ts'\nimport { isInteractive } from '../cli/env.ts'\nimport { NO_MODELS_MESSAGE, OAUTH_NOTE, pickModel } from '../cli/model-picker.ts'\nimport { defaultFeatures, updateConfig } from '../core/config.ts'\n\nfunction hasGhCli(): boolean {\n  if (process.env.SKILLD_NO_GH)\n    return false\n  try {\n    execSync('gh --version', { stdio: 'ignore' })\n    return true\n  }\n  catch {\n    return false\n  }\n}\n\nexport interface WizardOptions {\n  /** Resolved target agent, if known */\n  agent?: AgentType\n  /** Show next-steps outro when done (default: true) */\n  showOutro?: boolean\n}\n\nexport async function runWizard(opts: WizardOptions = {}): Promise<boolean> {\n  if (!isInteractive())\n    return false\n\n  const agentLabel = opts.agent ? agents[opts.agent].displayName : null\n  const skillsDir = opts.agent ? agents[opts.agent].skillsDir : '.claude/skills'\n  const agentLine = agentLabel\n    ? `\\n${styleText('gray', `Target agent: ${agentLabel}`)}`\n    : ''\n\n  p.note(\n    `Your AI agent reads docs from its training data - but APIs change,\\n`\n    + `versions drift, and patterns go stale. Skilld fixes this.\\n`\n    + `\\n`\n    + `It generates a ${styleText('bold', 'SKILL.md')} - a markdown reference card built from\\n`\n    + `the ${styleText('bold', 'actual docs, issues, and release notes')} for the exact\\n`\n    + `package versions in your project. Your agent reads this file\\n`\n    + `every session - no hallucinated APIs.\\n`\n    + `\\n`\n    + `${styleText('bold', 'How it works:')}\\n`\n    + `  1. Fetch docs, issues, and types for your packages\\n`\n    + `  2. Optionally compress with an LLM into a concise cheat sheet\\n`\n    + `\\n`\n    + `${styleText('gray', `Example: \\`skilld add vue\\` creates ${skillsDir}/vue-skilld/SKILL.md\\nYour agent then knows the right APIs, gotchas, and patterns\\nfor your exact version.`)}${agentLine}`,\n    'Welcome to skilld',\n  )\n\n  const ghInstalled = hasGhCli()\n\n  if (ghInstalled) {\n    p.log.success(\n      'GitHub CLI detected — will use it to pull issues and discussions.',\n    )\n  }\n  else {\n    p.log.info(\n      `${styleText('gray', 'GitHub CLI not installed — issues and discussions disabled.')}\\n`\n      + `  Install later to enable: ${styleText('cyan', 'https://cli.github.com')}`,\n    )\n  }\n\n  // Feature toggles\n  const selected = await p.multiselect({\n    message: 'What data sources should skills include?',\n    options: [\n      { label: 'Local search', value: 'search' as const, hint: 'query engine for `skilld search` across all skill docs' },\n      { label: 'Release notes', value: 'releases' as const, hint: 'changelogs and migration notes per version' },\n      { label: 'GitHub issues', value: 'issues' as const, hint: 'common bugs, workarounds, and solutions', disabled: !ghInstalled },\n      { label: 'GitHub discussions', value: 'discussions' as const, hint: 'community Q&A and usage examples', disabled: !ghInstalled },\n    ],\n    initialValues: [\n      ...Object.entries(defaultFeatures)\n        .filter(([, v]) => v)\n        .map(([k]) => k),\n      ...(ghInstalled ? ['issues', 'discussions'] as const : []),\n    ] as Array<keyof FeaturesConfig>,\n    required: false,\n  })\n\n  if (p.isCancel(selected)) {\n    p.cancel('Setup cancelled')\n    return false\n  }\n\n  const features: FeaturesConfig = {\n    search: selected.includes('search'),\n    issues: selected.includes('issues'),\n    discussions: selected.includes('discussions'),\n    releases: selected.includes('releases'),\n  }\n\n  // Enhancement model - optional, independent of target agent\n  p.note(\n    `An LLM can optionally summarize raw docs into a focused reference\\n`\n    + `highlighting best practices, gotchas, and migrations.\\n`\n    + `\\n`\n    + `${styleText('bold', 'Without LLM:')}  ~2 KB skill with package metadata, types, and links\\n`\n    + `${styleText('bold', 'With LLM:')}     ~5 KB skill with curated gotchas, patterns, and migration notes\\n`\n    + `\\n`\n    + `${styleText('bold', 'This is a one-time build step')} - it generates the SKILL.md, then your\\n`\n    + `coding agent reads the result every session. Can be a different model.\\n`\n    + `\\n`\n    + `${styleText('gray', 'Works with API keys (ANTHROPIC_API_KEY, GEMINI_API_KEY, OPENAI_API_KEY)\\nor CLI tools (claude, gemini, codex).')}`,\n    'Enhancement model (optional)',\n  )\n\n  let modelId: OptimizeModel | undefined\n  let skippedEnhancement = false\n  let oauthJustConnected = false\n\n  // Loop so user can connect OAuth then come back to pick a model\n  while (true) {\n    const allModels = process.env.SKILLD_NO_AGENTS ? [] : await getAvailableModels()\n\n    if (allModels.length === 0) {\n      p.log.warn(NO_MODELS_MESSAGE)\n    }\n    else if (oauthJustConnected) {\n      p.log.step(`${allModels.length} models now available. Select one below.`)\n    }\n    else {\n      // Show which providers were found by name (e.g. \"Anthropic via CLI, OpenAI via API key\")\n      const providers = new Set<string>()\n      for (const m of allModels) {\n        const vendor = m.vendorGroup ?? m.providerName\n        if (!m.id.startsWith('pi:'))\n          providers.add(`${vendor} via CLI`)\n        else if (m.hint?.includes('API key'))\n          providers.add(`${vendor} via API key`)\n        else if (m.hint?.includes('OAuth'))\n          providers.add(`${vendor} via OAuth`)\n      }\n      if (providers.size > 0)\n        p.log.success(`Found: ${[...providers].join(', ')}`)\n    }\n\n    const oauthProviders = getOAuthProviderList()\n    const afterOptions = oauthProviders.length > 0\n      ? [\n          { label: '⚠ Connect OAuth provider...', value: '_connect', hint: 'may violate provider ToS' },\n          { label: 'Skip enhancement', value: '_skip', hint: 'base skill with docs, issues, and types, add LLM later via `skilld config`' },\n        ]\n      : [\n          { label: 'Skip enhancement', value: '_skip', hint: 'base skill with docs, issues, and types, add LLM later via `skilld config`' },\n        ]\n\n    const choice = await pickModel(allModels, {\n      before: allModels.length > 0\n        ? [{ label: 'Auto', value: '_auto', hint: 'picks best available model from connected providers' }]\n        : [],\n      after: afterOptions,\n    })\n\n    if (choice === null) {\n      p.cancel('Setup cancelled')\n      return false\n    }\n\n    if (choice === '_connect') {\n      await wizardConnectProvider()\n      oauthJustConnected = true\n      continue\n    }\n\n    if (choice === '_skip') {\n      skippedEnhancement = true\n      break\n    }\n    if (choice === '_auto')\n      break\n\n    modelId = choice as OptimizeModel\n    break\n  }\n\n  updateConfig({\n    features,\n    ...(modelId\n      ? { model: modelId, skipLlm: false }\n      : { model: undefined, skipLlm: skippedEnhancement }),\n  })\n\n  // Summary of what was saved\n  const modelSummary = modelId\n    ? getModelName(modelId)\n    : skippedEnhancement\n      ? 'none (raw docs)'\n      : 'auto'\n  const featureList = Object.entries(features).filter(([, v]) => v).map(([k]) => k).join(', ') || 'none'\n  p.log.success(`Model: ${modelSummary} · Features: ${featureList}`)\n\n  if (opts.showOutro !== false) {\n    p.note(\n      `Run ${styleText('cyan', 'skilld add <pkg>')} to generate skills for specific packages\\n`\n      + `Run ${styleText('cyan', 'skilld')} to scan your project and pick packages interactively\\n`\n      + `Run ${styleText('cyan', 'skilld config')} to change settings later`,\n      'Setup complete',\n    )\n  }\n  return true\n}\n\nasync function wizardConnectProvider(): Promise<void> {\n  p.note(OAUTH_NOTE, 'How OAuth works')\n\n  const providers = getOAuthProviderList()\n  const provider = await p.select({\n    message: 'Connect provider',\n    options: providers.map(pr => ({\n      label: pr.name,\n      value: pr.id,\n      hint: pr.loggedIn ? 'connected' : undefined,\n    })),\n  })\n\n  if (p.isCancel(provider))\n    return\n\n  const spinner = p.spinner()\n  spinner.start('Connecting...')\n\n  const success = await loginOAuthProvider(provider as string, {\n    onAuth: (url, instructions) => {\n      spinner.stop('Open this URL in your browser:')\n      p.log.info(`  ${styleText('cyan', url)}`)\n      if (instructions)\n        p.log.info(`  ${styleText('gray', instructions)}`)\n      spinner.start('Waiting for authentication...')\n    },\n    onPrompt: async (message, placeholder) => {\n      const value = await p.text({ message, placeholder })\n      if (p.isCancel(value))\n        return ''\n      return value as string\n    },\n    onProgress: msg => p.log.step(msg),\n  }).catch((err: Error) => {\n    spinner.stop(`Login failed: ${err.message}`)\n    return false\n  })\n\n  spinner.stop()\n\n  if (success) {\n    const name = providers.find(pr => pr.id === provider)?.name ?? provider\n    p.log.success(`Connected to ${name}`)\n  }\n}\n\nexport const setupCommandDef = defineCommand({\n  meta: {\n    name: 'setup',\n    description: 'Re-run the setup wizard to configure features and model',\n  },\n  args: {\n    agent: sharedArgs.agent,\n  },\n  async run({ args }) {\n    const agent = resolveAgent(args.agent)\n    await runWizard({\n      agent: agent && agent !== 'none' ? agent as AgentType : undefined,\n    })\n  },\n})\n"],"mappings":"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"}

package/dist/cli.mjs

@@ -1,32 +1,40 @@
 #!/usr/bin/env node
-import { c as getOAuthProviderList, i as getAvailableModels, l as loginOAuthProvider, o as getModelName, t as detectImportedPackages, u as logoutOAuthProvider } from "./_chunks/agent.mjs";
-import { i as CACHE_DIR, s as getPackageDbPath, t as getCacheDir } from "./_chunks/version.mjs";
-import { i as readPackageJsonSafe } from "./_chunks/package-json.mjs";
-import "./_chunks/cache.mjs";
-import { n as getSharedSkillsDir, o as semverGt, r as mapInsert } from "./_chunks/shared.mjs";
-import { r as fetchNpmRegistryMeta, t as fetchLatestVersion } from "./_chunks/sources.mjs";
 import { a as targets, i as getAgentVersion, r as detectTargetAgent, t as detectInstalledAgents } from "./_chunks/detect.mjs";
-import { _ as timedSpinner, c as unlinkSkillFromAgents, f as formatSource, g as timeAgo } from "./_chunks/skill.mjs";
-import { a as readConfig, c as updateConfig, i as hasConfig, r as hasCompletedWizard, t as defaultFeatures } from "./_chunks/config.mjs";
-import { C as version, S as suggestPrepareHook, _ as promptForAgent, a as formatStatus, b as resolveAgent, c as getRepoHint, d as hasPrepareHook, f as introLine, g as pickModel, h as menuLoop, m as isRunningInsideAgent, n as NO_MODELS_MESSAGE, o as getInstalledGenerators, p as isInteractive, r as OAUTH_NOTE, u as guard, v as relativeTime, x as sharedArgs, y as requireInteractive } from "./_chunks/cli-helpers.mjs";
-import { o as removeLockEntry, r as parsePackages } from "./_chunks/lockfile.mjs";
+import { a as getModelName, c as getOAuthProviderList, l as loginOAuthProvider, n as detectImportedPackages, r as getAvailableModels, u as logoutOAuthProvider } from "./_chunks/agent.mjs";
+import { h as timedSpinner, m as timeAgo, o as unlinkSkillFromAgents, u as formatSource } from "./_chunks/prompts.mjs";
+import { f as getSharedSkillsDir, m as skillInternalDir, n as CACHE_DIR, u as getPackageDbPath } from "./_chunks/paths.mjs";
+import { h as VERSION_RANGE_PREFIX_RE, n as COMMA_OR_WHITESPACE_RE } from "./_chunks/regex.mjs";
+import { s as getCacheDir } from "./_chunks/prepare.mjs";
+import { i as readPackageJsonSafe } from "./_chunks/package-json.mjs";
+import { d as readConfig, l as hasCompletedWizard, m as updateConfig, o as defaultFeatures, u as hasConfig } from "./_chunks/cache.mjs";
+import { n as isRunningInsideAgent, r as requireInteractive, t as isInteractive } from "./_chunks/env.mjs";
+import { n as promptForAgent, r as resolveAgent } from "./_chunks/agent-prompt.mjs";
+import { t as sharedArgs } from "./_chunks/args.mjs";
+import { t as version } from "./_chunks/version.mjs";
+import { a as relativeTime, i as introLine, n as getInstalledGenerators, r as getRepoHint, t as formatStatus } from "./_chunks/intro.mjs";
+import { n as menuLoop, t as guard } from "./_chunks/menu.mjs";
+import { n as hasPrepareHook, r as suggestPrepareHook } from "./_chunks/prepare-hook2.mjs";
+import { n as OAUTH_NOTE, r as pickModel, t as NO_MODELS_MESSAGE } from "./_chunks/model-picker.mjs";
+import { c as resolveSkillName, f as fetchNpmRegistryMeta, l as toStoragePackageName, n as semverGt, u as fetchLatestVersion } from "./_chunks/semver.mjs";
+import { t as mapInsert } from "./_chunks/map.mjs";
+import { l as removeLockEntry, o as parsePackages } from "./_chunks/lockfile.mjs";
 import { i as iterateSkills, n as getSkillsDir, r as isOutdated, t as getProjectState } from "./_chunks/skills.mjs";
-import { n as resolveSkillName, r as toStoragePackageName } from "./_chunks/prefix.mjs";
-import { t as runWizard } from "./_chunks/wizard.mjs";
+import { t as runWizard } from "./_chunks/wizard2.mjs";
 import "./_chunks/core.mjs";
-import { join, resolve } from "pathe";
 import { existsSync, readFileSync, readdirSync, realpathSync, rmSync, statSync } from "node:fs";
-import pLimit from "p-limit";
+import { styleText } from "node:util";
 import * as p from "@clack/prompts";
 import { defineCommand, runMain } from "citty";
+import pLimit from "p-limit";
+import { join, resolve } from "pathe";
 import logUpdate from "log-update";
 async function configCommand() {
 	const initConfig = readConfig();
 	const agentId = initConfig.agent || detectTargetAgent() || void 0;
-	const cyan = (s) => `\x1B[36m${s}\x1B[90m`;
+	const cyan = (s) => styleText("cyan", s);
 	const modelLabel = initConfig.skipLlm ? "skip" : initConfig.model ? cyan(getModelName(initConfig.model)) : "auto";
 	const agentLabel = agentId && targets[agentId] ? cyan(targets[agentId].displayName) : "auto-detect";
-	p.note(`\x1B[90mFetch docs → Enhance with ${modelLabel} → Install to ${agentLabel}\x1B[0m`, "How skilld works");
+	p.note(styleText("gray", `Fetch docs → Enhance with ${modelLabel} → Install to ${agentLabel}`), "How skilld works");
 	await menuLoop({
 		message: "Settings",
 		options: () => {
@@ -136,7 +144,7 @@ async function configureOAuth() {
 			return getOAuthProviderList().map((pr) => ({
 				label: pr.name,
 				value: pr.id,
-				hint: pr.loggedIn ? "\x1B[32mconnected\x1B[0m" : "not connected"
+				hint: pr.loggedIn ? styleText("green", "connected") : "not connected"
 			}));
 		},
 		onSelect: async (providerId) => {
@@ -163,8 +171,8 @@ async function configureOAuth() {
 			const success = await loginOAuthProvider(providerId, {
 				onAuth: (url, instructions) => {
 					spinner.stop("Open this URL in your browser:");
-					p.log.info(`  \x1B[36m${url}\x1B[0m`);
-					if (instructions) p.log.info(`  \x1B[90m${instructions}\x1B[0m`);
+					p.log.info(`  ${styleText("cyan", url)}`);
+					if (instructions) p.log.info(`  ${styleText("gray", instructions)}`);
 					spinner.start("Waiting for authentication...");
 				},
 				onPrompt: async (message, placeholder) => {
@@ -344,7 +352,7 @@ const removeCommandDef = defineCommand({
 			packages: args.package ? [...new Set([args.package, ...args._ || []].map((s) => s.trim()).filter(Boolean).map((s) => {
 				const name = resolveSkillName(s);
 				if (!name) {
-					p.log.warn(`Cannot remove \x1B[36m${s}\x1B[0m: curator/collection inputs are not addressable here.`);
+					p.log.warn(`Cannot remove ${styleText("cyan", s)}: curator/collection inputs are not addressable here.`);
 					return null;
 				}
 				return name;
@@ -393,7 +401,7 @@ async function countEmbeddings(packageName, version) {
 	}
 }
 function countRefDocs(skillDir) {
-	const refsDir = join(skillDir, ".skilld");
+	const refsDir = skillInternalDir(skillDir);
 	if (!existsSync(refsDir)) return 0;
 	let count = 0;
 	const walk = (dir, depth = 0) => {
@@ -410,9 +418,9 @@ function countRefDocs(skillDir) {
 	walk(refsDir);
 	return count;
 }
-const dim = (s) => `\x1B[90m${s}\x1B[0m`;
-const bold = (s) => `\x1B[1m${s}\x1B[0m`;
-const green = (s) => `\x1B[32m${s}\x1B[0m`;
+const dim = (s) => styleText("gray", s);
+const bold = (s) => styleText("bold", s);
+const green = (s) => styleText("green", s);
 function getLastSynced() {
 	let latest = null;
 	for (const skill of iterateSkills()) if (skill.info?.syncedAt) {
@@ -582,8 +590,8 @@ function brandFrame(t, floor = 0, density = 0) {
 async function brandLoader(work, minMs = 1500) {
 	if (process.env.SKILLD_EFFECT === "none") return work();
 	const name = "\x1B[1m\x1B[38;2;255;255;255mskilld\x1B[0m";
-	const verStr = `\x1B[2mv${version}\x1B[0m`;
-	const status = "\x1B[2mSetting up your environment\x1B[0m";
+	const verStr = styleText("dim", `v${version}`);
+	const status = styleText("dim", "Setting up your environment");
 	const start = Date.now();
 	const sub = (raw) => raw.replace("%NAME%", name).replace("%VER%", verStr);
 	let done = false;
@@ -608,6 +616,7 @@ async function brandLoader(work, minMs = 1500) {
 	logUpdate.done();
 	return result;
 }
+const STATIC_REGEX_3 = /^[\^~>=<]/;
 const _emit = process.emit;
 process.emit = (event, ...args) => event === "warning" && args[0]?.name === "ExperimentalWarning" && args[0]?.message?.includes("SQLite") ? false : _emit.apply(process, [event, ...args]);
 function deprecatedForwarder(oldName, newName, loader) {
@@ -620,7 +629,7 @@ function deprecatedForwarder(oldName, newName, loader) {
 				name: oldName
 			},
 			async run(ctx) {
-				console.warn(`\x1B[33m⚠ \`skilld ${oldName}\` is deprecated. Use \`skilld ${newName}\` instead.\x1B[0m`);
+				console.warn(styleText("yellow", `⚠ \`skilld ${oldName}\` is deprecated. Use \`skilld ${newName}\` instead.`));
 				return original(ctx);
 			}
 		});
@@ -644,7 +653,11 @@ const SUBCOMMAND_NAMES = [
 	"prepare",
 	"author",
 	"publish",
-	"upload"
+	"upload",
+	"login",
+	"logout",
+	"whoami",
+	"pull"
 ];
 runMain(defineCommand({
 	meta: {
@@ -654,8 +667,8 @@ runMain(defineCommand({
 	},
 	args: { agent: sharedArgs.agent },
 	subCommands: {
-		add: () => import("./_chunks/sync2.mjs").then((m) => m.addCommandDef),
-		update: () => import("./_chunks/sync2.mjs").then((m) => m.updateCommandDef),
+		add: () => import("./_chunks/add.mjs").then((m) => m.addCommandDef),
+		update: () => import("./_chunks/update.mjs").then((m) => m.updateCommandDef),
 		info: () => infoCommandDef,
 		list: () => import("./_chunks/list.mjs").then((m) => m.listCommandDef),
 		config: () => configCommandDef,
@@ -665,9 +678,13 @@ runMain(defineCommand({
 		uninstall: () => import("./_chunks/uninstall.mjs").then((m) => m.uninstallCommandDef),
 		search: () => import("./_chunks/search.mjs").then((m) => m.searchCommandDef),
 		cache: () => import("./_chunks/cache2.mjs").then((m) => m.cacheCommandDef),
-		setup: () => import("./_chunks/setup.mjs").then((m) => m.setupCommandDef),
-		author: () => import("./_chunks/author-group.mjs").then((m) => m.authorGroupDef),
-		eject: deprecatedForwarder("eject", "author eject", () => import("./_chunks/sync2.mjs").then((m) => m.ejectCommandDef)),
+		setup: () => import("./_chunks/wizard.mjs").then((m) => m.setupCommandDef),
+		login: () => import("./_chunks/login.mjs").then((m) => m.loginCommandDef),
+		logout: () => import("./_chunks/logout.mjs").then((m) => m.logoutCommandDef),
+		whoami: () => import("./_chunks/whoami.mjs").then((m) => m.whoamiCommandDef),
+		pull: () => import("./_chunks/pull.mjs").then((m) => m.pullCommandDef),
+		author: () => import("./_chunks/author.mjs").then((m) => m.authorGroupDef),
+		eject: deprecatedForwarder("eject", "author eject", () => import("./_chunks/eject.mjs").then((m) => m.ejectCommandDef)),
 		validate: deprecatedForwarder("validate", "author validate", () => import("./_chunks/validate.mjs").then((m) => m.validateCommandDef)),
 		assemble: deprecatedForwarder("assemble", "author assemble", () => import("./_chunks/assemble.mjs").then((m) => m.assembleCommandDef)),
 		publish: deprecatedForwarder("publish", "author publish", () => import("./_chunks/upload.mjs").then((m) => m.uploadCommandDef)),
@@ -693,7 +710,8 @@ runMain(defineCommand({
 			if (!hasCompletedWizard()) {
 				if (!await runWizard()) return;
 			}
-			p.log.info("No agent selected - skills export as portable PROMPT_*.md files.\n  Run \x1B[36mskilld add <pkg>\x1B[0m to generate prompts for any package.\n  Run \x1B[36mskilld config\x1B[0m to set a target agent later.");
+			p.log.info(`No agent selected - skills export as portable PROMPT_*.md files.
+  Run ${styleText("cyan", "skilld add <pkg>")} to generate prompts for any package.\n  Run ${styleText("cyan", "skilld config")} to set a target agent later.`);
 			return;
 		}
 		const agent = currentAgent;
@@ -734,9 +752,9 @@ runMain(defineCommand({
 			};
 		});
 		if (selfUpdate) {
-			const released = selfUpdate.releasedAt ? `\x1B[90m · ${relativeTime(new Date(selfUpdate.releasedAt))}\x1B[0m` : "";
+			const released = selfUpdate.releasedAt ? styleText("gray", ` · ${relativeTime(new Date(selfUpdate.releasedAt))}`) : "";
 			const cmd = `npx nypm add${realpathSync(process.argv[1]).startsWith(resolve(cwd, "node_modules")) ? "" : " -g"} skilld@${selfUpdate.latest}`;
-			p.note(`\x1B[90m${version}\x1B[0m → \x1B[1m\x1B[32m${selfUpdate.latest}\x1B[0m${released}\n\x1B[36m${cmd}\x1B[0m`, "\x1B[33mUpdate available\x1B[0m");
+			p.note(`${styleText("gray", version)} → ${styleText(["bold", "green"], selfUpdate.latest)}${released}\n${styleText("cyan", cmd)}`, styleText("yellow", "Update available"));
 		}
 		if (state.skills.length === 0) {
 			if (!hasCompletedWizard()) {
@@ -748,13 +766,13 @@ runMain(defineCommand({
 			const projectPkg = readPackageJsonSafe(join(cwd, "package.json"));
 			const hasPkgJson = !!projectPkg;
 			const projectName = projectPkg?.parsed.name;
-			const projectLabel = projectName ? `Generating skills for \x1B[36m${projectName}\x1B[0m` : "Generating skills for current directory";
+			const projectLabel = projectName ? `Generating skills for ${styleText("cyan", projectName)}` : "Generating skills for current directory";
 			p.log.step(projectLabel);
 			if (!hasPkgJson) p.log.warn("No package.json found - enter npm package names manually.\n  For best results, run skilld inside a JS/TS project directory.");
 			if (state.shipped.length > 0) {
 				const totalShipped = state.shipped.reduce((sum, s) => sum + s.skills.length, 0);
 				const names = state.shipped.map((s) => s.packageName).join(", ");
-				p.log.info(`\x1B[36m${totalShipped} ready-to-use skill${totalShipped > 1 ? "s" : ""}\x1B[0m shipped by your dependencies: ${names}`);
+				p.log.info(`${styleText("cyan", `${totalShipped} ready-to-use skill${totalShipped > 1 ? "s" : ""}`)} shipped by your dependencies: ${names}`);
 			}
 			p.log.info("Tip: Add skills for packages with complex APIs or frequent breaking changes - not every dependency needs one.");
 			let setupComplete = false;
@@ -762,7 +780,7 @@ runMain(defineCommand({
 				const shippedOption = state.shipped.length > 0 ? [{
 					label: "Install shipped skills",
 					value: "shipped",
-					hint: `\x1B[36m${state.shipped.reduce((sum, s) => sum + s.skills.length, 0)} ready to use\x1B[0m`
+					hint: styleText("cyan", `${state.shipped.reduce((sum, s) => sum + s.skills.length, 0)} ready to use`)
 				}] : [];
 				const source = hasPkgJson ? await p.select({
 					message: "How should I find packages?",
@@ -794,13 +812,13 @@ runMain(defineCommand({
 					return;
 				}
 				if (source === "skip") {
-					p.log.info("Run \x1B[36mskilld add <pkg>\x1B[0m or \x1B[36mskilld\x1B[0m anytime to add skills.");
+					p.log.info(`Run ${styleText("cyan", "skilld add <pkg>")} or ${styleText("cyan", "skilld")} anytime to add skills.`);
 					return;
 				}
 				if (source === "shipped") {
-					const { handleShippedSkills: installShipped } = await import("./_chunks/sync-shared.mjs");
+					const { handleShippedSkills: installShipped } = await import("./_chunks/skill-installer.mjs");
 					for (const pkg of state.shipped) {
-						const version = state.deps.get(pkg.packageName)?.replace(/^[\^~>=<]+/, "") || "0.0.0";
+						const version = state.deps.get(pkg.packageName)?.replace(VERSION_RANGE_PREFIX_RE, "") || "0.0.0";
 						installShipped(pkg.packageName, version, cwd, agent, false);
 						for (const sk of pkg.skills) p.log.success(`Installed shipped skill: ${sk.skillName}`);
 					}
@@ -824,7 +842,7 @@ runMain(defineCommand({
 						p.log.warn("No packages entered");
 						continue;
 					}
-					selected = input.split(/[,\s]+/).map((s) => s.trim()).filter(Boolean);
+					selected = input.split(COMMA_OR_WHITESPACE_RE).map((s) => s.trim()).filter(Boolean);
 					if (selected.length === 0) {
 						p.log.warn("No valid packages entered");
 						continue;
@@ -880,7 +898,7 @@ runMain(defineCommand({
 					const choice = await p.multiselect({
 						message: `Select packages (${packages.length} found)`,
 						options: packages.map((name) => {
-							const ver = state.deps.get(name)?.replace(/^[\^~>=<]/, "") || "";
+							const ver = state.deps.get(name)?.replace(STATIC_REGEX_3, "") || "";
 							const repo = getRepoHint(name, cwd);
 							const hint = sourceMap.get(name) === "preset" ? "nuxt module" : void 0;
 							const pad = " ".repeat(maxLen - name.length + 2);
@@ -890,7 +908,7 @@ runMain(defineCommand({
 								repo
 							].filter(Boolean).join("  ");
 							return {
-								label: meta ? `${name}${pad}\x1B[90m${meta}\x1B[39m` : name,
+								label: meta ? `${name}${pad}${styleText("gray", meta)}` : name,
 								value: name
 							};
 						}),
@@ -921,7 +939,7 @@ runMain(defineCommand({
 					const previewContent = readFileSync(previewPath, "utf-8");
 					const previewLines = previewContent.split("\n").slice(0, 20).join("\n").replace(/\x1B\[[0-?]*[ -/]*[@-~]/g, "").replace(/\x1B\].*?(?:\x07|\x1B\\)/g, "");
 					const fileSize = (Buffer.byteLength(previewContent) / 1024).toFixed(1);
-					p.note(`\x1B[90m${previewLines}\n...\x1B[0m`, `${targets[agent].skillsDir}/${previewSkill.name}/SKILL.md (${fileSize} KB)`);
+					p.note(styleText("gray", `${previewLines}\n...`), `${targets[agent].skillsDir}/${previewSkill.name}/SKILL.md (${fileSize} KB)`);
 				}
 			}
 			const agentName = targets[agent].displayName;
@@ -937,10 +955,10 @@ runMain(defineCommand({
 				"amp": "Start a new Amp session.\nReads skill descriptions at startup, full content on invocation.",
 				"opencode": "Start a new OpenCode session.\nSkills are discovered automatically at startup.",
 				"roo": "Restart your editor. Roo reads skill descriptions at startup."
-			}[agent] ?? "" : `Skills are ready in ${targets[agent].skillsDir}/.\n\x1B[90m${agentName} was not detected on this machine.\nInstall it to use these skills, or run \`skilld config\` to change agents.\x1B[0m`;
+			}[agent] ?? "" : `Skills are ready in ${targets[agent].skillsDir}/.\n${styleText("gray", `${agentName} was not detected on this machine.\nInstall it to use these skills, or run \`skilld config\` to change agents.`)}`;
 			const firstPkg = previewSkill?.info?.packageName || previewSkill?.name;
-			const trySuggestion = firstPkg ? `\n\n\x1B[36mTry it:\x1B[0m ask your agent "What are the gotchas or breaking changes in ${firstPkg}?"` : "";
-			p.note(`${verifyLine}${trySuggestion}\n\nRun \x1B[36mskilld info\x1B[0m to see installed skills.\nRun \x1B[36mskilld\x1B[0m again to add more, update, or search.`, `${agentName} - next steps`);
+			const trySuggestion = firstPkg ? `\n\n${styleText("cyan", "Try it:")} ask your agent "What are the gotchas or breaking changes in ${firstPkg}?"` : "";
+			p.note(`${verifyLine}${trySuggestion}\n\nRun ${styleText("cyan", "skilld info")} to see installed skills.\nRun ${styleText("cyan", "skilld")} again to add more, update, or search.`, `${agentName} - next steps`);
 			try {
 				await suggestPrepareHook(cwd);
 			} catch (err) {
@@ -951,11 +969,11 @@ runMain(defineCommand({
 		const status = formatStatus(state.synced.length, state.outdated.length);
 		p.log.info(status);
 		let needsPrepareHook = !hasPrepareHook(cwd);
-		if (needsPrepareHook) p.log.warn(`\x1B[33mNo prepare hook.\x1B[0m Skills won't auto-restore on \x1B[36mnpm install\x1B[0m.`);
+		if (needsPrepareHook) p.log.warn(`${styleText("yellow", "No prepare hook.")} Skills won't auto-restore on ${styleText("cyan", "npm install")}.`);
 		if (state.shipped.length > 0) {
 			const totalSkills = state.shipped.reduce((sum, s) => sum + s.skills.length, 0);
 			const names = state.shipped.map((s) => s.packageName).join(", ");
-			p.log.info(`\x1B[36m${totalSkills} ready-to-use skill${totalSkills > 1 ? "s" : ""}\x1B[0m shipped by your dependencies: ${names}`);
+			p.log.info(`${styleText("cyan", `${totalSkills} ready-to-use skill${totalSkills > 1 ? "s" : ""}`)} shipped by your dependencies: ${names}`);
 		}
 		const refreshState = async () => {
 			state = await getProjectState(cwd);
@@ -969,7 +987,7 @@ runMain(defineCommand({
 					opts.push({
 						label: "Install shipped skills",
 						value: "shipped",
-						hint: `\x1B[36m${total} available\x1B[0m`
+						hint: styleText("cyan", `${total} available`)
 					});
 				}
 				opts.push({
@@ -979,12 +997,12 @@ runMain(defineCommand({
 				if (state.outdated.length > 0) opts.push({
 					label: "Update skills",
 					value: "update",
-					hint: `\x1B[33m${state.outdated.length} outdated\x1B[0m`
+					hint: styleText("yellow", `${state.outdated.length} outdated`)
 				});
 				if (needsPrepareHook) opts.push({
 					label: "Setup prepare hook",
 					value: "prepare-hook",
-					hint: "\x1B[33mrecommended\x1B[0m"
+					hint: styleText("yellow", "recommended")
 				});
 				opts.push({
 					label: "Remove skills",
@@ -1018,12 +1036,12 @@ runMain(defineCommand({
 							initialValues: allShipped
 						}));
 						if (selected.length === 0) return;
-						const { handleShippedSkills: installShipped } = await import("./_chunks/sync-shared.mjs");
+						const { handleShippedSkills: installShipped } = await import("./_chunks/skill-installer.mjs");
 						const seen = /* @__PURE__ */ new Set();
 						for (const s of selected) {
 							if (seen.has(s.packageName)) continue;
 							seen.add(s.packageName);
-							const version = state.deps.get(s.packageName)?.replace(/^[\^~>=<]+/, "") || "0.0.0";
+							const version = state.deps.get(s.packageName)?.replace(VERSION_RANGE_PREFIX_RE, "") || "0.0.0";
 							installShipped(s.packageName, version, cwd, agent, false);
 						}
 						p.log.success(`Installed ${selected.length} shipped skill${selected.length > 1 ? "s" : ""}`);
@@ -1062,7 +1080,7 @@ runMain(defineCommand({
 								placeholder: "vue nuxt pinia"
 							}));
 							if (!input) return;
-							selected = input.split(/[,\s]+/).map((s) => s.trim()).filter(Boolean);
+							selected = input.split(COMMA_OR_WHITESPACE_RE).map((s) => s.trim()).filter(Boolean);
 							if (selected.length === 0) return;
 						} else {
 							let usages;
@@ -1118,7 +1136,7 @@ runMain(defineCommand({
 							const choice = guard(await p.multiselect({
 								message: `Select packages your agent struggles with or that are new to you (${packages.length} found)`,
 								options: packages.map((name) => {
-									const ver = state.deps.get(name)?.replace(/^[\^~>=<]/, "") || "";
+									const ver = state.deps.get(name)?.replace(STATIC_REGEX_3, "") || "";
 									const repo = getRepoHint(name, cwd);
 									const hint = sourceMap.get(name) === "preset" ? "nuxt module" : frameworks.has(name) ? "framework" : (usageMap.get(name)?.count ?? 0) >= 5 ? `${usageMap.get(name).count} imports` : void 0;
 									const pad = " ".repeat(maxLen - name.length + 2);
@@ -1128,7 +1146,7 @@ runMain(defineCommand({
 										repo
 									].filter(Boolean).join("  ");
 									return {
-										label: meta ? `${name}${pad}\x1B[90m${meta}\x1B[39m` : name,
+										label: meta ? `${name}${pad}${styleText("gray", meta)}` : name,
 										value: name
 									};
 								}),