ccski 1.0.1 → 1.0.3

package/README.md

@@ -50,7 +50,12 @@ Interactive pickers across install/enable/disable share the same layout, colors,
 - **openskills** — established the SKILL.md authoring pattern; we align with that spec for compatibility.
 - **universal-skills** — offers a curated, ready-to-use skill set; ccski focuses on management and transport, not bundling content.
 
-Key differences: ccski is a manager/server (no baked-in skill corpus), MCP-first, and optimized for multi-root discovery plus install/enable/disable ergonomics.
+Key differences and what we fused:
+- We blend **universal-skills’ MCP-first philosophy** with **openskills’ CLI ergonomics** so the same tool serves both agents and humans.
+- ccski uniquely **scans skills shipped inside Claude Code plugins**, which universal-skills and openskills don’t cover.
+- The `install` command accepts flexible sources (git URLs, marketplace, SKILL.md paths) and `-i` provides an interactive picker with a live one-shot command preview.
+
+Bottom line: ccski is a manager/server (no baked-in corpus), MCP-first, multi-root-aware, with a friendlier install/enable/disable workflow.
 
 ## 4) Contributing & architecture at a glance
 

package/dist/cli.mjs

@@ -22775,33 +22775,40 @@ async function startMCPServer(options = {}) {
 	});
 }
 function buildSkillDescription(registry) {
-	return `Execute a skill within the main conversation
+	const skills = registry.getAll();
+	const diagnostics = registry.getDiagnostics();
+	const exampleCommands = skills.slice(0, 2).map((skill) => `  - command: "${skill.name}"`);
+	const skillBlocks = skills.map((skill) => {
+		const location = skill.location === "user" ? "global" : skill.location;
+		return [
+			"<skill>",
+			`<name>${skill.name}</name>`,
+			`<description>${skill.description}</description>`,
+			`<location>${location}</location>`,
+			"</skill>"
+		].join("\n");
+	}).join("\n");
+	const discoveryLines = ["- `<available_skills>` is generated from the skills discovered on this machine at runtime.", "- Discovery scans project and user skill directories"];
+	if (diagnostics.pluginSources.length > 0) discoveryLines.push(`- Plugin skills loaded from: ${diagnostics.pluginSources.join(", ")}`);
+	const exampleSection = exampleCommands.length > 0 ? ["- Examples:", ...exampleCommands].join("\n") : "";
+	return `${`Execute a skill within the main conversation
 
 <skills_instructions>
 When users ask you to perform tasks, check if any of the available skills below can help complete the task more effectively. Skills provide specialized capabilities and domain knowledge.
 
+Source of truth:
+${discoveryLines.join("\n")}
+
 How to use skills:
-- Invoke skills using this tool with the skill name only (no arguments)
+- Invoke this tool with the skill name only (case-insensitive)
 - The skill's prompt will expand and provide detailed instructions on how to complete the task
-- Examples:
-  - command: "pdf" - invoke the pdf skill
-  - command: "xlsx" - invoke the xlsx skill
-  - command: "plugin:pdf" - invoke using fully qualified name
+${exampleSection}
 
 Important:
-- Only use skills listed in <available_skills> below
+- Only use skills listed in <available_skills> below (this list reflects what is actually installed)
 - Do not invoke a skill that is already running
 - Do not use this tool for built-in CLI commands (like /help, /clear, etc.)
-</skills_instructions>\n\n${`<available_skills>\n${registry.getAll().map((skill) => {
-		const location = skill.location === "user" ? "global" : skill.location;
-		return [
-			"<skill>",
-			`<name>${skill.name}</name>`,
-			`<description>${skill.description}</description>`,
-			`<location>${location}</location>`,
-			"</skill>"
-		].join("\n");
-	}).join("\n") || "<skill>\n<name>none</name>\n<description>No skills discovered</description>\n<location>none</location>\n</skill>"}\n</available_skills>`}`;
+</skills_instructions>`}\n\n${`<available_skills>\n${skillBlocks || "<skill>\n<name>none</name>\n<description>No skills discovered</description>\n<location>none</location>\n</skill>"}\n</available_skills>`}`;
 }
 function formatSkillContent(skill) {
 	return `${[