@ikhono/mcp 0.1.2 → 0.1.3

package/README.md

@@ -83,7 +83,7 @@ IKHONO_API_TOKEN=YOUR_TOKEN npx @ikhono/mcp
 
 | Tool | Description |
 |------|-------------|
-| `ikhono_skill_search` | Search for skills by query, category, or author |
+| `ikhono_skill_search` | Search for skills by query, category, or author (returns top 3 previews) |
 | `ikhono_skill_get` | Load a skill's full instructions by slug |
 | `ikhono_skill_pin` | Pin a skill to your favorites |
 | `ikhono_skill_unpin` | Remove a skill from your favorites |
@@ -92,7 +92,7 @@ IKHONO_API_TOKEN=YOUR_TOKEN npx @ikhono/mcp
 
 ### ikhono_skill_search
 
-Search for skills matching a query.
+Search for skills matching a query. Returns a concise preview of the top results (default: 3) with name, description, rating, and usage stats. Use `ikhono_skill_get` to load the full skill instructions.
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
@@ -100,7 +100,7 @@ Search for skills matching a query.
 | `category` | string | No | Filter by category |
 | `author` | string | No | Filter by author (e.g., "@alice") |
 | `mine` | boolean | No | Show only your skills |
-| `limit` | number | No | Max results (default: 5) |
+| `limit` | number | No | Max results (default: 3) |
 
 ### ikhono_skill_get
 
@@ -135,9 +135,11 @@ Rate a skill after using it.
 ## How It Works
 
 1. Your AI agent receives a task (e.g., "review this code")
-2. The agent calls `ikhono_skill_search` to find relevant skills
-3. The agent calls `ikhono_skill_get` to load the skill's instructions
-4. The agent follows those instructions for a better, more structured response
+2. The agent calls `ikhono_skill_search` to find relevant skills (top 3 previews)
+3. The user picks which skill to load — the agent calls `ikhono_skill_get` with that slug
+4. The agent follows the skill's instructions for a better, more structured response
+
+If none of the results fit, the user can ask to search again with a higher `limit` or a different query.
 
 Skills are community-created Markdown documents with structured processes, checklists, and templates. The MCP server is a thin proxy to the iKhono API — no local storage or computation needed.
 

package/dist/index.js

@@ -85,9 +85,26 @@ var searchToolSchema = z.object({
   category: z.string().optional().describe('Filter by category (e.g., "security", "testing", "documentation")'),
   author: z.string().optional().describe('Filter by author username (e.g., "@alice" or "alice")'),
   mine: z.boolean().optional().describe("Set to true to show only your own skills (requires authentication)"),
-  limit: z.number().optional().default(5).describe("Maximum number of results to return")
+  limit: z.number().optional().default(3).describe("Maximum number of results to return")
 });
 var searchToolDescription = `Search iKhono for AI skills that match a query. Use this when the user asks you to do something that could benefit from specialized expertise. Returns a list of matching skills with their names, descriptions, ratings, usage counts, and pin counts.`;
+function formatSearchResults(results) {
+  if (results.length === 0) {
+    return "No skills found matching your query.";
+  }
+  const lines = [`Found ${results.length} skill${results.length === 1 ? "" : "s"}:
+`];
+  for (let i = 0; i < results.length; i++) {
+    const r = results[i];
+    const rating = r.avgRating > 0 ? `${r.avgRating.toFixed(1)}/5 (${r.ratingCount} rating${r.ratingCount === 1 ? "" : "s"})` : "no ratings yet";
+    lines.push(`${i + 1}. ${r.slug} (v${r.latestVersion})`);
+    lines.push(`   ${r.description}`);
+    lines.push(`   ${rating} \xB7 ${r.totalUses} uses \xB7 ${r.pinCount} pins`);
+    lines.push("");
+  }
+  lines.push("Load a skill with ikhono_skill_get using the slug.");
+  return lines.join("\n");
+}
 async function handleSearch(client2, args2) {
   const results = await client2.searchSkills(args2.query, {
     category: args2.category,
@@ -151,7 +168,7 @@ async function handleRate(client2, args2) {
 // src/version.ts
 import { createRequire } from "module";
 function getVersion() {
-  if (true) return "0.1.2";
+  if (true) return "0.1.3";
   const require2 = createRequire(import.meta.url);
   return require2("../package.json").version;
 }
@@ -191,7 +208,7 @@ var server = new McpServer({
 server.tool(searchToolName, searchToolDescription, searchToolSchema.shape, async (args2) => {
   try {
     const results = await handleSearch(client, searchToolSchema.parse(args2));
-    return { content: [{ type: "text", text: JSON.stringify(results, null, 2) }] };
+    return { content: [{ type: "text", text: formatSearchResults(results) }] };
   } catch (err) {
     return { content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }], isError: true };
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikhono/mcp",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "iKhono MCP Server — runtime skill router for AI agents",
   "type": "module",
   "bin": {