local-skills-mcp 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## 0.4.0 (2025-11-10)
+
+- feat: add skill descriptions to ListTools output ([2451bcb](https://github.com/kdpa-llc/local-skills-mcp/commit/2451bcb)), closes [#50](https://github.com/kdpa-llc/local-skills-mcp/issues/50)
+
 ## 0.3.0 (2025-11-10)
 
 - feat: automate version syncing with generated server.json ([ad12154](https://github.com/kdpa-llc/local-skills-mcp/commit/ad12154))

package/dist/index.js

@@ -132,7 +132,24 @@ export class LocalSkillsServer {
                 "Invoke with the skill name to receive detailed instructions that enhance your problem-solving approach with structured, expert-level guidance.";
             // Package built-in skills ensure there are always skills available
             if (skillNames.length > 0) {
-                getSkillDescription += `\n\nAvailable skills: ${skillNames.join(", ")}`;
+                // Fetch metadata for each skill to get descriptions
+                const skillsWithDescriptions = [];
+                for (const skillName of skillNames) {
+                    try {
+                        const metadata = await this.skillLoader.getSkillMetadata(skillName);
+                        // Truncate description if too long (max 100 chars)
+                        let description = metadata.description;
+                        if (description.length > 100) {
+                            description = description.substring(0, 97) + "...";
+                        }
+                        skillsWithDescriptions.push(`- ${skillName}: ${description}`);
+                    }
+                    catch {
+                        // If metadata fails to load, just show the skill name
+                        skillsWithDescriptions.push(`- ${skillName}`);
+                    }
+                }
+                getSkillDescription += `\n\nAvailable skills:\n${skillsWithDescriptions.join("\n")}`;
             }
             const tools = [
                 {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "local-skills-mcp",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Universal MCP server enabling any LLM or AI agent to utilize expert skills from your local filesystem. Reduces context consumption through lazy loading - only skill names visible initially, full content loads on-demand. Works with Claude, Cline, custom agents, and any MCP-compatible client.",
   "type": "module",
   "main": "dist/index.js",