skilld 0.4.2 → 0.5.0

package/dist/agent/index.d.mts

@@ -266,6 +266,8 @@ interface AgentTarget {
   detectProject: (cwd: string) => boolean;
   /** CLI command name (if agent has a CLI for skill generation) */
   cli?: string;
+  /** Project-level instruction file for always-on rules (e.g. CLAUDE.md, AGENTS.md) */
+  instructionFile?: string;
   /** Required skill filename (always SKILL.md for Agent Skills spec agents) */
   skillFilename: string;
   /** Project-level skill directory */

package/dist/agent/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/agent/prompts/optional/types.ts","../../src/agent/prompts/prompt.ts","../../src/agent/prompts/skill.ts","../../src/agent/types.ts","../../src/agent/clis/types.ts","../../src/agent/clis/index.ts","../../src/agent/detect.ts","../../src/agent/detect-imports.ts","../../src/agent/install.ts","../../src/agent/targets/types.ts","../../src/agent/targets/registry.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/agent/prompts/optional/types.ts","../../src/agent/prompts/prompt.ts","../../src/agent/prompts/skill.ts","../../src/agent/types.ts","../../src/agent/clis/types.ts","../../src/agent/clis/index.ts","../../src/agent/detect.ts","../../src/agent/detect-imports.ts","../../src/agent/install.ts","../../src/agent/targets/types.ts","../../src/agent/targets/registry.ts"],"mappings":"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"}

package/dist/cli.mjs

@@ -59,6 +59,11 @@ const CONFIG_PATH = join(CONFIG_DIR, "config.yaml");
 function hasConfig() {
 	return existsSync(CONFIG_PATH);
 }
+function hasCompletedWizard() {
+	if (!existsSync(CONFIG_PATH)) return false;
+	const config = readConfig();
+	return config.features !== void 0 || config.model !== void 0 || config.skipLlm !== void 0;
+}
 function readConfig() {
 	if (!existsSync(CONFIG_PATH)) return {};
 	const content = readFileSync(CONFIG_PATH, "utf-8");
@@ -978,6 +983,7 @@ async function syncPackagesParallel(config) {
 		}
 	}
 	await ensureGitignore(getSharedSkillsDir(cwd) ? SHARED_SKILLS_DIR : agent.skillsDir, cwd, config.global);
+	await ensureAgentInstructions(config.agent, cwd, config.global);
 	await shutdownWorker();
 	p.outro(`Synced ${successfulPkgs.length}/${packages.length} packages`);
 }
@@ -1183,6 +1189,30 @@ async function ensureGitignore(skillsDir, cwd, isGlobal) {
 	else writeFileSync(gitignorePath, entry);
 	p.log.success("Updated .gitignore");
 }
+const SKILLD_MARKER_START = "<!-- skilld -->";
+const SKILLD_MARKER_END = "<!-- /skilld -->";
+const SKILLD_INSTRUCTIONS = `${SKILLD_MARKER_START}
+Before modifying code, evaluate each installed skill against the current task.
+For each skill, determine YES/NO relevance and invoke all YES skills before proceeding.
+${SKILLD_MARKER_END}`;
+async function ensureAgentInstructions(agent, cwd, isGlobal) {
+	if (isGlobal) return;
+	const agentConfig = targets[agent];
+	if (!agentConfig.instructionFile) return;
+	const filePath = join(cwd, agentConfig.instructionFile);
+	if (existsSync(filePath)) {
+		if (readFileSync(filePath, "utf-8").includes(SKILLD_MARKER_START)) return;
+	}
+	p.note(SKILLD_INSTRUCTIONS, `Will be added to ${agentConfig.instructionFile}`);
+	const add = await p.confirm({
+		message: `Add skill activation instructions to ${agentConfig.instructionFile}?`,
+		initialValue: true
+	});
+	if (p.isCancel(add) || !add) return;
+	if (existsSync(filePath)) appendFileSync(filePath, `${readFileSync(filePath, "utf-8").endsWith("\n") ? "" : "\n"}\n${SKILLD_INSTRUCTIONS}\n`);
+	else writeFileSync(filePath, `${SKILLD_INSTRUCTIONS}\n`);
+	p.log.success(`Updated ${agentConfig.instructionFile}`);
+}
 async function syncCommand(state, opts) {
 	if (opts.packages && opts.packages.length > 0) {
 		if (opts.packages.length > 1) return syncPackagesParallel({
@@ -1577,6 +1607,7 @@ async function syncSinglePackage(packageName, config) {
 	if (shared) linkSkillToAgents(skillDirName, shared, cwd);
 	if (!config.global) registerProject(cwd);
 	await ensureGitignore(shared ? SHARED_SKILLS_DIR : targets[config.agent].skillsDir, cwd, config.global);
+	await ensureAgentInstructions(config.agent, cwd, config.global);
 	await shutdownWorker();
 	p.outro(`Synced ${packageName} to ${relative(cwd, skillDir)}`);
 }
@@ -2755,6 +2786,23 @@ async function statusCommand(opts = {}) {
 	const total = localPkgs.size + globalPkgs.size;
 	p.log.info(`${total} package${total !== 1 ? "s" : ""}`);
 }
+function removeAgentInstructions(agent, projectPath) {
+	const agentConfig = targets[agent];
+	if (!agentConfig.instructionFile) return false;
+	const filePath = join(projectPath, agentConfig.instructionFile);
+	if (!existsSync(filePath)) return false;
+	const content = readFileSync(filePath, "utf-8");
+	const startIdx = content.indexOf(SKILLD_MARKER_START);
+	if (startIdx === -1) return false;
+	const endIdx = content.indexOf(SKILLD_MARKER_END, startIdx);
+	if (endIdx === -1) return false;
+	const before = content.slice(0, startIdx).replace(/\n+$/, "");
+	const after = content.slice(endIdx + 16).replace(/^\n+/, "");
+	const updated = before + (before && after ? "\n" : "") + after;
+	if (updated.trim() === "") rmSync(filePath);
+	else writeFileSync(filePath, updated.endsWith("\n") ? updated : `${updated}\n`);
+	return true;
+}
 async function uninstallCommand(opts) {
 	let scope = opts.scope;
 	const registeredProjects = getRegisteredProjects();
@@ -2895,6 +2943,11 @@ async function uninstallCommand(opts) {
 		force: true
 	});
 	for (const [prefix, items] of groups) p.log.success(`Removed ${prefix}: ${formatGroup(items)}`);
+	const agentTypes = agentFilter || Object.keys(targets);
+	for (const proj of projectsToUnregister) for (const agent of agentTypes) if (removeAgentInstructions(agent, proj)) {
+		const file = targets[agent].instructionFile;
+		p.log.success(`Cleaned ${file}`);
+	}
 	if (scope !== "all") for (const proj of projectsToUnregister) unregisterProject(proj);
 	p.outro("skilld uninstalled");
 }
@@ -3619,7 +3672,7 @@ runMain(defineCommand({
 			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");
 		}
 		if (state.skills.length === 0) {
-			if (!hasConfig()) await runWizard();
+			if (!hasCompletedWizard()) await runWizard();
 			const pkgJsonPath = join(cwd, "package.json");
 			const hasPkgJson = existsSync(pkgJsonPath);
 			const projectName = hasPkgJson ? JSON.parse(readFileSync(pkgJsonPath, "utf-8")).name : void 0;