@hasna/skills 0.1.46 → 0.1.48

package/bin/mcp.js

@@ -6510,7 +6510,7 @@ var require_dist = __commonJS((exports, module) => {
 });
 
 // src/lib/config.ts
-import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync } from "fs";
+import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync, readdirSync, statSync } from "fs";
 import { join, dirname } from "path";
 import { homedir } from "os";
 function validKeys() {
@@ -6521,6 +6521,24 @@ function allowedValues(key) {
     return MODE_VALUES;
   return ENUM_KEYS[key];
 }
+function mergeDirectoryContents(sourceDir, targetDir) {
+  if (!existsSync(sourceDir))
+    return;
+  mkdirSync(targetDir, { recursive: true });
+  for (const entry of readdirSync(sourceDir)) {
+    const sourcePath = join(sourceDir, entry);
+    const targetPath = join(targetDir, entry);
+    try {
+      const sourceStat = statSync(sourcePath);
+      if (sourceStat.isDirectory()) {
+        mergeDirectoryContents(sourcePath, targetPath);
+        continue;
+      }
+      if (!existsSync(targetPath))
+        copyFileSync(sourcePath, targetPath);
+    } catch {}
+  }
+}
 function normalizeConfigValue(key, value) {
   if (typeof value !== "string")
     return;
@@ -6544,14 +6562,17 @@ function normalizeConfigValue(key, value) {
 function getDataDir() {
   const home = process.env["HOME"] || process.env["USERPROFILE"] || homedir();
   const newDir = join(home, ".hasna", "skills");
+  const oldDir = join(home, ".skills");
   const oldConfigFile = join(home, ".skillsrc");
+  mkdirSync(newDir, { recursive: true });
+  try {
+    mergeDirectoryContents(oldDir, newDir);
+  } catch {}
   if (existsSync(oldConfigFile) && !existsSync(join(newDir, "config.json"))) {
-    mkdirSync(newDir, { recursive: true });
     try {
       copyFileSync(oldConfigFile, join(newDir, "config.json"));
     } catch {}
   }
-  mkdirSync(newDir, { recursive: true });
   return newDir;
 }
 function getConfigPath(scope) {
@@ -6625,7 +6646,8 @@ var init_skill_aliases = __esm(() => {
     "pdf-reader": "read-pdf",
     "generate-image": "image",
     "image-generator": "image",
-    "create-blog-article": "blog-article"
+    "create-blog-article": "blog-article",
+    "skill-diff": "diff-viewer"
   };
 });
 
@@ -7042,7 +7064,7 @@ var init_pricing = __esm(() => {
     { slug: "brand-kit", displayName: "Brand Kit", tier: "premium", costCents: 400, providers: ["hosted"], description: "Hosted brand kit with logo usage, palette, typography, brand voice, sample applications, Markdown guide, PDF guide, and SVG assets" },
     { slug: "generate-book-cover", displayName: "Book Cover", tier: "premium", costCents: 20, providers: ["gpt-image-2"], description: "Professional book cover design from title and genre" },
     { slug: "remove-background", displayName: "Remove Background", tier: "premium", costCents: 10, providers: ["gemini-3-pro"], description: "AI-powered background removal from images" },
-    { slug: "transcript", displayName: "Transcript", tier: "premium", costCents: 10, providers: ["whisper"], description: "Audio/video transcription with timestamps" },
+    { slug: "transcript", displayName: "Transcript", tier: "premium", costCents: 10, providers: ["openai", "elevenlabs", "deepgram", "hosted"], description: "Audio/video transcription with timestamps, diarization, and URL support" },
     { slug: "webcrawling", displayName: "Web Crawling", tier: "premium", costCents: 5, providers: ["firecrawl"], description: "Structured web page crawling and extraction" },
     { slug: "browse", displayName: "Browse", tier: "premium", costCents: 5, providers: ["browser"], description: "Web browsing and page interaction" },
     { slug: "read-pdf", displayName: "Read PDF", tier: "premium", costCents: 5, providers: ["cerebras"], description: "Hosted PDF extraction and structured content analysis" },
@@ -18269,7 +18291,7 @@ function finalize(ctx, schema) {
     result.$schema = "http://json-schema.org/draft-07/schema#";
   } else if (ctx.target === "draft-04") {
     result.$schema = "http://json-schema.org/draft-04/schema#";
-  } else if (ctx.target === "openapi-3.0") {}
+  } else if (ctx.target === "openapi-3.0") {} else {}
   if (ctx.external?.uri) {
     const id = ctx.external.registry.get(schema)?.id;
     if (!id)
@@ -18517,7 +18539,7 @@ var literalProcessor = (schema, ctx, json, _params) => {
     if (val === undefined) {
       if (ctx.unrepresentable === "throw") {
         throw new Error("Literal `undefined` cannot be represented in JSON Schema");
-      }
+      } else {}
     } else if (typeof val === "bigint") {
       if (ctx.unrepresentable === "throw") {
         throw new Error("BigInt literals cannot be represented in JSON Schema");
@@ -21797,7 +21819,7 @@ class StdioServerTransport {
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.1.46",
+  version: "0.1.48",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -21866,7 +21888,7 @@ var package_default = {
     typescript: "^5"
   },
   dependencies: {
-    "@hasna/events": "^0.1.3",
+    "@hasna/events": "^0.1.7",
     "@modelcontextprotocol/sdk": "^1.26.0",
     chalk: "^5.3.0",
     commander: "^12.1.0",
@@ -29480,7 +29502,7 @@ var EMPTY_COMPLETION_RESULT = {
 
 // src/lib/registry.ts
 init_config();
-import { existsSync as existsSync4, readFileSync as readFileSync4, readdirSync as readdirSync3 } from "fs";
+import { existsSync as existsSync4, readFileSync as readFileSync4, readdirSync as readdirSync4 } from "fs";
 import { join as join4 } from "path";
 
 // src/lib/portable-skills.ts
@@ -29491,16 +29513,16 @@ import {
   lstatSync as lstatSync2,
   mkdirSync as mkdirSync2,
   readFileSync as readFileSync3,
-  readdirSync as readdirSync2,
+  readdirSync as readdirSync3,
   rmSync,
-  statSync as statSync2,
+  statSync as statSync3,
   writeFileSync as writeFileSync2
 } from "fs";
 import { basename, dirname as dirname2, isAbsolute as isAbsolute2, join as join3, normalize as normalize2, relative } from "path";
 
 // src/lib/skill-validation.ts
 init_pricing();
-import { existsSync as existsSync2, lstatSync, readFileSync as readFileSync2, readdirSync, statSync } from "fs";
+import { existsSync as existsSync2, lstatSync, readFileSync as readFileSync2, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
 import { isAbsolute, join as join2, normalize } from "path";
 var DOC_FILES = ["SKILL.md", "README.md", "CLAUDE.md"];
 var RESERVED_SKILL_ENTRIES = new Set([
@@ -29656,7 +29678,7 @@ function validateSkillDirectory(name, skillPath, registryMeta) {
   if (!VALID_BIN_COMMAND.test(bareName)) {
     add(issues, "skill.name_invalid", `Skill name '${bareName}' must use lowercase letters, numbers, dots, underscores, or hyphens`);
   }
-  for (const entry of readdirSync(skillPath).sort()) {
+  for (const entry of readdirSync2(skillPath).sort()) {
     const entryPath = join2(skillPath, entry);
     if (RESERVED_SKILL_ENTRIES.has(entry)) {
       add(issues, "skill.reserved_file", `Reserved file '${entry}' is not allowed in skill packages`);
@@ -29771,7 +29793,7 @@ function validateSkillDirectory(name, skillPath, registryMeta) {
             const targetPath = join2(skillPath, target);
             if (!existsSync2(targetPath)) {
               add(warnings, "package.bin_target_missing", `package.json bin '${command}' target '${target}' is not present before build`);
-            } else if (statSync(targetPath).isDirectory()) {
+            } else if (statSync2(targetPath).isDirectory()) {
               add(issues, "package.bin_target_directory", `package.json bin '${command}' target '${target}' must point to a file, not a directory`);
             }
           }
@@ -29794,7 +29816,7 @@ function validateSkillDirectory(name, skillPath, registryMeta) {
     add(issues, "skill.src_index_missing", "Missing src/index.ts or src/index.js");
   } else {
     const indexPath = existsSync2(join2(srcDir, "index.ts")) ? join2(srcDir, "index.ts") : join2(srcDir, "index.js");
-    const size = statSync(indexPath).size;
+    const size = statSync2(indexPath).size;
     if (size < 50)
       add(warnings, "skill.src_index_minimal", `Source entry point is very small (${size}B)`);
   }
@@ -29861,7 +29883,7 @@ function findPortableSkill(name, options = {}) {
     return null;
   }
   const path = getPortableSkillPath(normalized, options);
-  if (!existsSync3(path) || !statSync2(path).isDirectory())
+  if (!existsSync3(path) || !statSync3(path).isDirectory())
     return null;
   try {
     return summarizePortableSkill(path, normalized);
@@ -29874,7 +29896,7 @@ function listPortableSkills(options = {}) {
   if (!existsSync3(root))
     return [];
   const skills = [];
-  for (const entry of readdirSync2(root).sort()) {
+  for (const entry of readdirSync3(root).sort()) {
     if (entry.startsWith(".") || DATA_DIR_NON_SKILL_ENTRIES.has(entry))
       continue;
     const path = join3(root, entry);
@@ -29950,7 +29972,7 @@ function scaffoldPortableSkill(name, options = {}) {
 }
 function portPortableSkill(sourcePath, options = {}) {
   const absoluteSource = normalize2(sourcePath);
-  if (!existsSync3(absoluteSource) || !statSync2(absoluteSource).isDirectory()) {
+  if (!existsSync3(absoluteSource) || !statSync3(absoluteSource).isDirectory()) {
     throw new Error(`Skill source directory not found: ${sourcePath}`);
   }
   const inferred = readPortableSkillManifest(absoluteSource, basename(absoluteSource));
@@ -30019,7 +30041,7 @@ function validatePortableSkillDirectory(name, skillPath) {
             const entryPath = join3(skillPath, command.entry);
             if (!existsSync3(entryPath))
               add2(issues, "portable.command_entry_missing", `Command '${command.name}' entry '${command.entry}' is missing`);
-            else if (statSync2(entryPath).isDirectory())
+            else if (statSync3(entryPath).isDirectory())
               add2(issues, "portable.command_entry_directory", `Command '${command.name}' entry '${command.entry}' must be a file`);
           }
         }
@@ -30387,7 +30409,7 @@ function displayName(name) {
 }
 function safeIsDirectory(path) {
   try {
-    return statSync2(path).isDirectory();
+    return statSync3(path).isDirectory();
   } catch {
     return false;
   }
@@ -31601,9 +31623,9 @@ var MEDIA_PROCESSING_SKILLS = [
   {
     name: "transcript",
     displayName: "Transcript",
-    description: "Generate transcripts from audio and video files with timestamps",
+    description: "Transcribe audio, video, and media URLs with OpenAI GPT-4o, ElevenLabs Scribe v2, DeepGram, or hosted runtime",
     category: "Media Processing",
-    tags: ["transcript", "audio", "video", "speech-to-text"]
+    tags: ["transcript", "audio", "video", "speech-to-text", "diarization", "youtube"]
   },
   {
     name: "video-cut-suggester",
@@ -32383,7 +32405,7 @@ function discoverSkillsInDir(dir) {
     return [];
   const result = [];
   try {
-    const entries = readdirSync3(dir, { withFileTypes: true });
+    const entries = readdirSync4(dir, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.isDirectory())
         continue;
@@ -33047,18 +33069,29 @@ var runOutputSchema = objectSchema({
   exitCode: { type: "number", description: "Process exit code for local runs." },
   skill: stringSchema("Canonical skill slug."),
   remote: { type: "boolean", description: "Whether the skill was submitted to the hosted runtime." },
-  stdout: stringSchema("Captured stdout for local runs."),
-  stderr: stringSchema("Captured stderr for local runs."),
+  stdoutPreview: objectSchema({
+    text: stringSchema("Truncated stdout preview."),
+    length: { type: "number" },
+    truncated: { type: "boolean" }
+  }, [], "Default compact stdout preview."),
+  stderrPreview: objectSchema({
+    text: stringSchema("Truncated stderr preview."),
+    length: { type: "number" },
+    truncated: { type: "boolean" }
+  }, [], "Default compact stderr preview."),
+  stdout: stringSchema("Captured stdout for local runs when detail:true is requested."),
+  stderr: stringSchema("Captured stderr for local runs when detail:true is requested."),
   id: stringSchema("Remote run id when submitted remotely."),
   localRunId: stringSchema("Local run metadata id."),
   status: stringSchema("Run lifecycle status."),
   pricing: pricingSchema,
-  remoteRun: objectSchema({}, [], "Normalized hosted remote run contract.", true),
-  run: objectSchema({}, [], "Local run metadata.", true),
+  remoteRun: objectSchema({}, [], "Compact hosted remote run summary by default; full contract when detail:true is requested.", true),
+  run: objectSchema({}, [], "Compact local run metadata by default; full metadata when detail:true is requested.", true),
   nextActions: objectSchema({
     poll: stringSchema("Command to poll run status."),
     download: stringSchema("Command to download artifacts.")
-  })
+  }),
+  detailHint: stringSchema("How to request the complete payload.")
 }, [], "Skill run result.");
 var toolContracts = [
   {
@@ -33106,7 +33139,7 @@ var toolContracts = [
   {
     name: "list_skills",
     title: "List Skills",
-    description: "List skills from the basic or full registry profile.",
+    description: "List skills from the basic or full registry profile. Returns a compact paged envelope by default.",
     params: ["category?", "profile?", "detail?", "limit?", "offset?"],
     category: "discovery",
     sideEffects: "none",
@@ -33122,7 +33155,11 @@ var toolContracts = [
       skills: arraySchema(skillSummarySchema),
       total: { type: "number" },
       offset: { type: "number" },
-      limit: { type: "number" }
+      limit: { type: "number" },
+      nextOffset: { type: "number" },
+      hasMore: { type: "boolean" },
+      nextArguments: objectSchema({}, [], "Arguments for the next page.", true),
+      detailHint: stringSchema("How to request fuller skill objects.")
     })
   },
   {
@@ -33143,7 +33180,7 @@ var toolContracts = [
   {
     name: "search_skills",
     title: "Search Skills",
-    description: "Search skills by name, description, or tags.",
+    description: "Search skills by name, description, or tags. Returns a compact paged envelope by default.",
     params: ["query", "profile?", "detail?", "limit?", "offset?"],
     category: "discovery",
     sideEffects: "none",
@@ -33155,7 +33192,16 @@ var toolContracts = [
       limit: { type: "number", minimum: 0 },
       offset: { type: "number", minimum: 0 }
     }, ["query"]),
-    outputSchema: objectSchema({ skills: arraySchema(skillSummarySchema) })
+    outputSchema: objectSchema({
+      skills: arraySchema(skillSummarySchema),
+      total: { type: "number" },
+      offset: { type: "number" },
+      limit: { type: "number" },
+      nextOffset: { type: "number" },
+      hasMore: { type: "boolean" },
+      nextArguments: objectSchema({}, [], "Arguments for the next page.", true),
+      detailHint: stringSchema("How to request fuller skill objects.")
+    })
   },
   {
     name: "get_skill_info",
@@ -33272,8 +33318,8 @@ var toolContracts = [
   {
     name: "run_skill",
     title: "Run Skill",
-    description: "Run a skill locally or through a configured remote runner.",
-    params: ["name", "input?", "args?", "approved?"],
+    description: "Run a skill locally or through a configured remote runner. Returns compact stdout/stderr previews and run summaries by default; pass detail:true for full records.",
+    params: ["name", "input?", "args?", "approved?", "detail?"],
     category: "execution",
     sideEffects: "local-process-or-remote-run",
     stable: true,
@@ -33281,28 +33327,33 @@ var toolContracts = [
       name: skillNameInput,
       input: runInputSchema,
       args: runArgsSchema,
-      approved: paidRunApprovalSchema
+      approved: paidRunApprovalSchema,
+      detail: { type: "boolean", default: false, description: "Return full stdout/stderr, remote run, and local run metadata." }
     }, ["name"]),
     outputSchema: runOutputSchema
   },
   {
     name: "get_run_status",
     title: "Get Run Status",
-    description: "Fetch remote run status and next actions.",
-    params: ["run_id"],
+    description: "Fetch remote run status and next actions. Returns a compact status summary by default; pass detail:true for the complete remote run payload.",
+    params: ["run_id", "detail?"],
     category: "execution",
     sideEffects: "none",
     stable: true,
-    inputSchema: objectSchema({ run_id: stringSchema("Remote or local run id.") }, ["run_id"]),
+    inputSchema: objectSchema({
+      run_id: stringSchema("Remote or local run id."),
+      detail: { type: "boolean", default: false, description: "Return the complete remote run payload." }
+    }, ["run_id"]),
     outputSchema: objectSchema({
       contractVersion: { type: "number", description: "Remote run payload contract version." },
       runId: stringSchema("Remote run id."),
       localRunId: stringSchema("Local run id."),
-      run: objectSchema({}, [], "Normalized remote run status.", true),
+      run: objectSchema({}, [], "Compact remote run status by default; full status when detail:true is requested.", true),
       nextActions: objectSchema({
         poll: stringSchema("Command to poll run status."),
         download: stringSchema("Command to download artifacts.")
-      })
+      }),
+      detailHint: stringSchema("How to request the complete payload.")
     })
   },
   {
@@ -33397,13 +33448,25 @@ var toolContracts = [
   {
     name: "list_schedules",
     title: "List Schedules",
-    description: "List scheduled skill runs.",
-    params: [],
+    description: "List scheduled skill runs as a compact paged envelope.",
+    params: ["limit?", "offset?"],
     category: "scheduling",
     sideEffects: "none",
     stable: true,
-    inputSchema: objectSchema(),
-    outputSchema: arraySchema(objectSchema({}, [], "Schedule record.", true))
+    inputSchema: objectSchema({
+      limit: { type: "number", minimum: 0 },
+      offset: { type: "number", minimum: 0 }
+    }),
+    outputSchema: objectSchema({
+      schedules: arraySchema(objectSchema({}, [], "Compact schedule record.", true)),
+      total: { type: "number" },
+      offset: { type: "number" },
+      limit: { type: "number" },
+      nextOffset: { type: "number" },
+      hasMore: { type: "boolean" },
+      nextArguments: objectSchema({}, [], "Arguments for the next page.", true),
+      detailHint: stringSchema("How to request complete schedule details.")
+    })
   },
   {
     name: "remove_schedule",
@@ -33810,6 +33873,90 @@ function resolveDiscoveryPricing(skill) {
   return skill.pricing && typeof skill.pricing.formattedCost === "string" ? skill.pricing : getPublicSkillPricing(skill.name);
 }
 
+// src/lib/compact-output.ts
+var DEFAULT_MCP_LIMIT = 25;
+var MAX_PAGE_LIMIT = 200;
+var DEFAULT_PREVIEW_CHARS = 600;
+function truncateText(value, maxChars = 96) {
+  const text = String(value ?? "").replace(/\s+/g, " ").trim();
+  if (text.length <= maxChars)
+    return text;
+  return `${text.slice(0, Math.max(0, maxChars - 3)).trimEnd()}...`;
+}
+function previewText(value, maxChars = DEFAULT_PREVIEW_CHARS) {
+  const text = String(value ?? "");
+  return {
+    text: text.length > maxChars ? `${text.slice(0, Math.max(0, maxChars - 3))}...` : text,
+    length: text.length,
+    truncated: text.length > maxChars
+  };
+}
+function parsePageLimit(value, fallback, options = {}) {
+  const max = options.max ?? MAX_PAGE_LIMIT;
+  if (typeof value === "string" && options.allowAll && value.trim().toLowerCase() === "all") {
+    return Number.POSITIVE_INFINITY;
+  }
+  const parsed = typeof value === "number" ? value : Number.parseInt(value ?? "", 10);
+  if (!Number.isFinite(parsed))
+    return fallback;
+  if (options.allowAll && parsed === 0)
+    return Number.POSITIVE_INFINITY;
+  if (parsed <= 0)
+    return fallback;
+  return Math.min(parsed, max);
+}
+function parsePageOffset(value, fallback = 0) {
+  const parsed = typeof value === "number" ? value : Number.parseInt(value ?? "", 10);
+  if (!Number.isFinite(parsed) || parsed < 0)
+    return fallback;
+  return parsed;
+}
+function paginate(items, options) {
+  const offset = Math.min(parsePageOffset(options.offset), items.length);
+  const effectiveLimit = Number.isFinite(options.limit) ? Math.max(0, Math.min(options.limit, MAX_PAGE_LIMIT)) : Math.max(0, items.length - offset);
+  const pageItems = items.slice(offset, offset + effectiveLimit);
+  const nextOffset = offset + pageItems.length < items.length ? offset + pageItems.length : null;
+  return {
+    items: pageItems,
+    total: items.length,
+    offset,
+    limit: effectiveLimit,
+    hasMore: nextOffset !== null,
+    nextOffset
+  };
+}
+function compactRunRecord(run) {
+  if (!run || typeof run !== "object")
+    return {};
+  return {
+    id: run.id,
+    skill: run.skill,
+    status: run.status,
+    startedAt: run.startedAt,
+    ...run.completedAt ? { completedAt: run.completedAt } : {},
+    ...run.remoteRunId ? { remoteRunId: run.remoteRunId } : {},
+    ...run.costCents !== undefined ? { costCents: run.costCents } : {},
+    ...run.error ? { error: truncateText(run.error, 240) } : {},
+    artifactCount: Array.isArray(run.artifacts) ? run.artifacts.length : 0,
+    paths: run.paths
+  };
+}
+function compactRemoteRun(run) {
+  if (!run || typeof run !== "object")
+    return {};
+  return {
+    ...run.contractVersion !== undefined ? { contractVersion: run.contractVersion } : {},
+    id: run.id,
+    skill: run.skill ?? run.requestedSlug,
+    status: run.status,
+    ...run.correlationId ? { correlationId: run.correlationId } : {},
+    ...run.createdAt ? { createdAt: run.createdAt } : {},
+    ...run.startedAt ? { startedAt: run.startedAt } : {},
+    ...run.completedAt ? { completedAt: run.completedAt } : {},
+    ...run.error || run.errorMessage ? { error: truncateText(run.error ?? run.errorMessage, 240) } : {}
+  };
+}
+
 // src/mcp/helpers.ts
 function stripNulls(obj) {
   return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== null && v !== undefined && !(Array.isArray(v) && v.length === 0)));
@@ -33858,7 +34005,7 @@ var TOOL_DESCRIPTIONS = getMcpToolDescriptions();
 function registerDiscoveryTools(server) {
   server.registerTool("list_skills", {
     title: "List Skills",
-    description: "List skills with public pricing. Defaults to the clean basic profile to avoid context overflow. Set profile:'all' for the full registry. Returns {name,category,pricing} by default; detail:true for full public objects. Supports limit/offset pagination.",
+    description: "List skills with public pricing. Defaults to a compact paged response from the basic profile to avoid context overflow. Set profile:'all' for the full registry, detail:true for full public objects, and use limit/offset to page.",
     inputSchema: {
       category: exports_external.string().optional(),
       profile: exports_external.enum(["basic", "all"]).optional(),
@@ -33870,16 +34017,20 @@ function registerDiscoveryTools(server) {
     const selectedProfile = profile || "basic";
     const skills = category ? loadRegistryProfile(selectedProfile).filter((s) => s.category === category) : loadRegistryProfile(selectedProfile);
     const mapped = detail ? skills.map(getPublicSkillDiscovery) : skills.map(getCompactSkillDiscovery);
-    if (limit !== undefined || offset !== undefined) {
-      const start = offset || 0;
-      const sliced = limit !== undefined ? mapped.slice(start, start + limit) : mapped.slice(start);
-      return {
-        content: [{ type: "text", text: JSON.stringify({ skills: sliced, total: mapped.length, offset: start, limit: limit ?? null }) }]
-      };
-    }
-    return {
-      content: [{ type: "text", text: JSON.stringify(mapped) }]
-    };
+    const page = paginate(mapped, {
+      limit: parsePageLimit(limit, DEFAULT_MCP_LIMIT, { max: 100 }),
+      offset: parsePageOffset(offset)
+    });
+    return mcpJson({
+      skills: page.items,
+      total: page.total,
+      offset: page.offset,
+      limit: page.limit,
+      nextOffset: page.nextOffset,
+      hasMore: page.hasMore,
+      nextArguments: page.hasMore ? { profile: selectedProfile, category, detail: Boolean(detail), limit: page.limit, offset: page.nextOffset } : null,
+      detailHint: detail ? undefined : "Set detail:true for full public skill objects, or call get_skill_info for one skill."
+    });
   });
   server.registerTool("list_pinned_skills", {
     title: "List Pinned Skills",
@@ -33896,7 +34047,7 @@ function registerDiscoveryTools(server) {
   });
   server.registerTool("search_skills", {
     title: "Search Skills",
-    description: "Search skills by name, description, or tags. Defaults to the clean basic profile; set profile:'all' for the full registry. Returns compact list with pricing by default. Supports limit/offset pagination.",
+    description: "Search skills by name, description, or tags. Defaults to a compact paged response from the basic profile; set profile:'all' for the full registry and detail:true for full public objects.",
     inputSchema: {
       query: exports_external.string(),
       profile: exports_external.enum(["basic", "all"]).optional(),
@@ -33912,16 +34063,20 @@ function registerDiscoveryTools(server) {
     if (!cached2)
       cacheSet(cacheKey, results);
     const out = detail ? results.map(getPublicSkillDiscovery) : results.map(getCompactSkillDiscovery);
-    if (limit !== undefined || offset !== undefined) {
-      const start = offset || 0;
-      const sliced = limit !== undefined ? out.slice(start, start + limit) : out.slice(start);
-      return {
-        content: [{ type: "text", text: JSON.stringify({ skills: sliced, total: out.length, offset: start, limit: limit ?? null }) }]
-      };
-    }
-    return {
-      content: [{ type: "text", text: JSON.stringify(out) }]
-    };
+    const page = paginate(out, {
+      limit: parsePageLimit(limit, DEFAULT_MCP_LIMIT, { max: 100 }),
+      offset: parsePageOffset(offset)
+    });
+    return mcpJson({
+      skills: page.items,
+      total: page.total,
+      offset: page.offset,
+      limit: page.limit,
+      nextOffset: page.nextOffset,
+      hasMore: page.hasMore,
+      nextArguments: page.hasMore ? { query, profile: selectedProfile, detail: Boolean(detail), limit: page.limit, offset: page.nextOffset } : null,
+      detailHint: detail ? undefined : "Set detail:true for full public skill objects, or call get_skill_info for one skill."
+    });
   });
   server.registerTool("get_skill_info", {
     title: "Get Skill Info",
@@ -33966,12 +34121,12 @@ function registerDiscoveryTools(server) {
 }
 
 // src/mcp/operation-tools.ts
-import { existsSync as existsSync10, readdirSync as readdirSync5, statSync as statSync4 } from "fs";
+import { existsSync as existsSync10, readdirSync as readdirSync6, statSync as statSync5 } from "fs";
 import { join as join10 } from "path";
 
 // src/lib/run-state.ts
 import { createHash, randomBytes } from "crypto";
-import { existsSync as existsSync8, mkdirSync as mkdirSync4, readFileSync as readFileSync8, readdirSync as readdirSync4, statSync as statSync3, writeFileSync as writeFileSync4 } from "fs";
+import { existsSync as existsSync8, mkdirSync as mkdirSync4, readFileSync as readFileSync8, readdirSync as readdirSync5, statSync as statSync4, writeFileSync as writeFileSync4 } from "fs";
 import { extname, join as join8, relative as relative2 } from "path";
 function createSkillRun(params, targetDir = process.cwd()) {
   const now = new Date;
@@ -34045,7 +34200,7 @@ function findSkillRun(runId, targetDir = process.cwd()) {
   const runsRoot = join8(getProjectStateDir(targetDir), "runs");
   if (!existsSync8(runsRoot))
     return null;
-  for (const day of readdirSync4(runsRoot)) {
+  for (const day of readdirSync5(runsRoot)) {
     const record3 = readRunRecord(join8(runsRoot, day, runId));
     if (record3)
       return record3;
@@ -34065,7 +34220,7 @@ function collectRunArtifacts(context) {
     return [];
   const artifacts = [];
   for (const path of walkFiles(context.exportDir)) {
-    const stat = statSync3(path);
+    const stat = statSync4(path);
     const bytes = readFileSync8(path);
     artifacts.push({
       path: toProjectRelative(context.targetDir, path),
@@ -34088,9 +34243,9 @@ function readRunRecord(runDir) {
 }
 function walkFiles(dir) {
   const files = [];
-  for (const entry of readdirSync4(dir)) {
+  for (const entry of readdirSync5(dir)) {
     const full = join8(dir, entry);
-    if (statSync3(full).isDirectory())
+    if (statSync4(full).isDirectory())
       files.push(...walkFiles(full));
     else
       files.push(full);
@@ -34362,9 +34517,10 @@ function registerOperationTools(server) {
       name: exports_external.string(),
       input: exports_external.record(exports_external.string(), exports_external.unknown()).optional(),
       args: exports_external.array(exports_external.string()).optional(),
-      approved: exports_external.boolean().optional()
+      approved: exports_external.boolean().optional(),
+      detail: exports_external.boolean().optional()
     }
-  }, async ({ name, input, args, approved }) => {
+  }, async ({ name, input, args, approved, detail }) => {
     const skill = getSkill(name);
     if (!skill) {
       return mcpError("SKILL_NOT_FOUND", `Skill '${name}' not found`, findSimilarSkills(name));
@@ -34430,7 +34586,7 @@ function registerOperationTools(server) {
         });
         writeRunLogs(runContext, "", "");
         const remoteRunId = typeof run.id === "string" ? run.id : undefined;
-        return mcpJson({
+        const payload2 = {
           contractVersion: REMOTE_SKILL_RUN_CONTRACT_VERSION,
           id: run.id,
           localRunId: localRun2.id,
@@ -34441,7 +34597,8 @@ function registerOperationTools(server) {
           remoteRun: run,
           run: localRun2,
           nextActions: remoteRunNextActions(remoteRunId)
-        });
+        };
+        return mcpJson(detail ? payload2 : compactRunToolPayload(payload2, "Call run_skill again with detail:true for full remote/local run records."));
       } catch (err) {
         const error48 = `Hosted skill ${skillName} requires hosted access: ${err.message}`;
         writeRunLogs(runContext, "", error48 + `
@@ -34463,23 +34620,23 @@ function registerOperationTools(server) {
       status: result.exitCode === 0 ? "completed" : "failed",
       error: result.error
     });
+    const payload = { exitCode: result.exitCode, skill: skillName, stdout: result.stdout, stderr: result.stderr, run: localRun };
     if (result.error) {
       return {
-        content: [{ type: "text", text: JSON.stringify({ exitCode: result.exitCode, error: result.error, run: localRun }, null, 2) }],
+        content: [{ type: "text", text: JSON.stringify(detail ? { ...payload, error: result.error } : compactRunToolPayload({ ...payload, error: result.error }, "Call run_skill again with detail:true for full stdout/stderr and run metadata.")) }],
         isError: true
       };
     }
-    return {
-      content: [{ type: "text", text: JSON.stringify({ exitCode: result.exitCode, skill: skillName, stdout: result.stdout, stderr: result.stderr, run: localRun }, null, 2) }]
-    };
+    return mcpJson(detail ? payload : compactRunToolPayload(payload, "Call run_skill again with detail:true for full stdout/stderr and run metadata."));
   });
   server.registerTool("get_run_status", {
     title: "Get Run Status",
     description: "Fetch remote run status. Accepts a remote run id or a local run id linked to a remote run.",
     inputSchema: {
-      run_id: exports_external.string()
+      run_id: exports_external.string(),
+      detail: exports_external.boolean().optional()
     }
-  }, async ({ run_id }) => {
+  }, async ({ run_id, detail }) => {
     const { getApiKey: getApiKey2 } = await Promise.resolve().then(() => (init_auth_store(), exports_auth_store));
     const apiKey = getApiKey2();
     if (!apiKey) {
@@ -34496,12 +34653,20 @@ function registerOperationTools(server) {
       const run = await client.getRun(remoteRunId);
       if (!run)
         return mcpError("RUN_NOT_FOUND", `Remote run '${remoteRunId}' not found`);
-      return mcpJson({
+      const payload = {
         contractVersion: REMOTE_SKILL_RUN_CONTRACT_VERSION,
         runId: remoteRunId,
         ...localRun ? { localRunId: localRun.id } : {},
         run,
         nextActions: remoteRunNextActions(remoteRunId)
+      };
+      return mcpJson(detail ? payload : {
+        contractVersion: payload.contractVersion,
+        runId: payload.runId,
+        ...localRun ? { localRunId: localRun.id } : {},
+        run: compactRemoteRun(run),
+        nextActions: payload.nextActions,
+        detailHint: "Call get_run_status with detail:true for the complete remote run payload."
       });
     } catch (err) {
       return mcpError("SKILLS_MD_ERROR", err.message);
@@ -34573,9 +34738,9 @@ function registerOperationTools(server) {
       let skillCount = 0;
       if (exists) {
         try {
-          skillCount = readdirSync5(agentSkillsPath).filter((f) => {
+          skillCount = readdirSync6(agentSkillsPath).filter((f) => {
             const full = join10(agentSkillsPath, f);
-            return !f.startsWith(".") && statSync4(full).isDirectory();
+            return !f.startsWith(".") && statSync5(full).isDirectory();
           }).length;
         } catch {}
       }
@@ -34593,6 +34758,32 @@ function registerOperationTools(server) {
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
 }
+function compactRunToolPayload(payload, detailHint) {
+  const stdout = previewText(payload.stdout ?? "");
+  const stderr = previewText(payload.stderr ?? "");
+  return {
+    ...payload.contractVersion !== undefined ? { contractVersion: payload.contractVersion } : {},
+    ...payload.id !== undefined ? { id: payload.id } : {},
+    ...payload.localRunId !== undefined ? { localRunId: payload.localRunId } : {},
+    ...payload.exitCode !== undefined ? { exitCode: payload.exitCode } : {},
+    skill: payload.skill,
+    ...payload.status !== undefined ? { status: payload.status } : {},
+    ...payload.remote !== undefined ? { remote: payload.remote } : {},
+    ...payload.correlationId !== undefined ? { correlationId: payload.correlationId } : {},
+    ...payload.pricing !== undefined ? { pricing: payload.pricing } : {},
+    ...payload.error !== undefined ? { error: payload.error } : {},
+    ...payload.remoteRun !== undefined ? { remoteRun: compactRemoteRun(payload.remoteRun) } : {},
+    run: compactRunRecord(payload.run),
+    stdoutPreview: stdout,
+    stderrPreview: stderr,
+    stdoutChars: stdout.length,
+    stderrChars: stderr.length,
+    stdoutTruncated: stdout.truncated,
+    stderrTruncated: stderr.truncated,
+    ...payload.nextActions !== undefined ? { nextActions: payload.nextActions } : {},
+    detailHint
+  };
+}
 
 // src/lib/feedback.ts
 import { existsSync as existsSync11, mkdirSync as mkdirSync6 } from "fs";
@@ -34951,11 +35142,37 @@ function registerScheduleTools(server) {
   });
   server.registerTool("list_schedules", {
     title: "List Schedules",
-    description: "List all scheduled skill runs.",
-    inputSchema: {}
-  }, async () => {
+    description: "List scheduled skill runs as a compact paged response. Use limit/offset for pagination.",
+    inputSchema: {
+      limit: exports_external.number().optional(),
+      offset: exports_external.number().optional()
+    }
+  }, async ({ limit, offset }) => {
     const schedules = listSchedules();
-    return { content: [{ type: "text", text: JSON.stringify(schedules, null, 2) }] };
+    const page = paginate(schedules, {
+      limit: parsePageLimit(limit, DEFAULT_MCP_LIMIT, { max: 100 }),
+      offset: parsePageOffset(offset)
+    });
+    return mcpJson({
+      schedules: page.items.map((schedule) => ({
+        id: schedule.id,
+        name: schedule.name,
+        skill: schedule.skill,
+        cron: schedule.cron,
+        enabled: schedule.enabled,
+        lastRun: schedule.lastRun,
+        lastRunStatus: schedule.lastRunStatus,
+        nextRun: schedule.nextRun,
+        argCount: schedule.args?.length ?? 0
+      })),
+      total: page.total,
+      offset: page.offset,
+      limit: page.limit,
+      nextOffset: page.nextOffset,
+      hasMore: page.hasMore,
+      nextArguments: page.hasMore ? { limit: page.limit, offset: page.nextOffset } : null,
+      detailHint: "Use schedule state files or future schedule detail commands for complete schedule records."
+    });
   });
   server.registerTool("remove_schedule", {
     title: "Remove Schedule",
@@ -35011,8 +35228,8 @@ import {
   existsSync as existsSync13,
   mkdirSync as mkdirSync8,
   readFileSync as readFileSync11,
-  readdirSync as readdirSync6,
-  statSync as statSync5,
+  readdirSync as readdirSync7,
+  statSync as statSync6,
   writeFileSync as writeFileSync7
 } from "fs";
 import { dirname as dirname5, join as join13, normalize as normalize3, relative as relative3, sep } from "path";
@@ -35206,9 +35423,9 @@ function parsePositiveInteger(value) {
 }
 function walkFiles2(dir) {
   const files = [];
-  for (const entry of readdirSync6(dir)) {
+  for (const entry of readdirSync7(dir)) {
     const full = join13(dir, entry);
-    const stats = statSync5(full);
+    const stats = statSync6(full);
     if (stats.isDirectory())
       files.push(...walkFiles2(full));
     else