@hasna/skills 0.1.46 → 0.1.48

package/dist/index.js

@@ -15,11 +15,11 @@ var __export = (target, all) => {
 };
 
 // src/lib/registry.ts
-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/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";
 var ENUM_KEYS = {
@@ -45,6 +45,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;
@@ -68,14 +86,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) {
@@ -146,15 +167,15 @@ 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
-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";
 
 // src/lib/skill-aliases.ts
@@ -170,7 +191,8 @@ var SKILL_ALIASES = {
   "pdf-reader": "read-pdf",
   "generate-image": "image",
   "image-generator": "image",
-  "create-blog-article": "blog-article"
+  "create-blog-article": "blog-article",
+  "skill-diff": "diff-viewer"
 };
 function normalizeSkillSlug(name) {
   return name.trim();
@@ -199,7 +221,7 @@ var PREMIUM_SKILLS = [
   { 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" },
@@ -787,7 +809,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`);
@@ -902,7 +924,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`);
             }
           }
@@ -925,7 +947,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)`);
   }
@@ -947,9 +969,9 @@ function validateRegistryConsistency(registry, skillsDir) {
     seen.add(name);
     return false;
   })));
-  const skillDirs = existsSync2(skillsDir) ? readdirSync(skillsDir).filter((entry) => {
+  const skillDirs = existsSync2(skillsDir) ? readdirSync2(skillsDir).filter((entry) => {
     const fullPath = join2(skillsDir, entry);
-    return !entry.startsWith(".") && entry !== "_common" && statSync(fullPath).isDirectory();
+    return !entry.startsWith(".") && entry !== "_common" && statSync2(fullPath).isDirectory();
   }) : [];
   const directoryNames = new Set(skillDirs);
   const registryNameSet = new Set(registryNames);
@@ -1016,7 +1038,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);
@@ -1029,7 +1051,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);
@@ -1105,7 +1127,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));
@@ -1174,7 +1196,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`);
           }
         }
@@ -1595,7 +1617,7 @@ function displayName(name) {
 }
 function safeIsDirectory(path) {
   try {
-    return statSync2(path).isDirectory();
+    return statSync3(path).isDirectory();
   } catch {
     return false;
   }
@@ -2806,9 +2828,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",
@@ -3591,7 +3613,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;
@@ -4062,7 +4084,7 @@ function loadProjectConfigCompat(targetDir) {
 }
 // src/lib/run-state.ts
 import { createHash, randomBytes } from "crypto";
-import { existsSync as existsSync7, mkdirSync as mkdirSync4, readFileSync as readFileSync7, readdirSync as readdirSync4, statSync as statSync3, writeFileSync as writeFileSync4 } from "fs";
+import { existsSync as existsSync7, mkdirSync as mkdirSync4, readFileSync as readFileSync7, readdirSync as readdirSync5, statSync as statSync4, writeFileSync as writeFileSync4 } from "fs";
 import { extname, join as join7, relative as relative2 } from "path";
 function createSkillRun(params, targetDir = process.cwd()) {
   const now = new Date;
@@ -4137,11 +4159,11 @@ function listSkillRuns(targetDir = process.cwd(), limit = 50) {
   if (!existsSync7(runsRoot))
     return [];
   const records = [];
-  for (const day of readdirSync4(runsRoot).sort().reverse()) {
+  for (const day of readdirSync5(runsRoot).sort().reverse()) {
     const dayDir = join7(runsRoot, day);
-    if (!statSync3(dayDir).isDirectory())
+    if (!statSync4(dayDir).isDirectory())
       continue;
-    for (const runId of readdirSync4(dayDir).sort().reverse()) {
+    for (const runId of readdirSync5(dayDir).sort().reverse()) {
       const record = readRunRecord(join7(dayDir, runId));
       if (record)
         records.push(record);
@@ -4155,7 +4177,7 @@ function findSkillRun(runId, targetDir = process.cwd()) {
   const runsRoot = join7(getProjectStateDir(targetDir), "runs");
   if (!existsSync7(runsRoot))
     return null;
-  for (const day of readdirSync4(runsRoot)) {
+  for (const day of readdirSync5(runsRoot)) {
     const record = readRunRecord(join7(runsRoot, day, runId));
     if (record)
       return record;
@@ -4178,7 +4200,7 @@ function collectRunArtifacts(context) {
     return [];
   const artifacts = [];
   for (const path of walkFiles(context.exportDir)) {
-    const stat = statSync3(path);
+    const stat = statSync4(path);
     const bytes = readFileSync7(path);
     artifacts.push({
       path: toProjectRelative(context.targetDir, path),
@@ -4201,9 +4223,9 @@ function readRunRecord(runDir) {
 }
 function walkFiles(dir) {
   const files = [];
-  for (const entry of readdirSync4(dir)) {
+  for (const entry of readdirSync5(dir)) {
     const full = join7(dir, entry);
-    if (statSync3(full).isDirectory())
+    if (statSync4(full).isDirectory())
       files.push(...walkFiles(full));
     else
       files.push(full);
@@ -15482,7 +15504,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)
@@ -15730,7 +15752,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");
@@ -18811,7 +18833,7 @@ import { dirname as dirname4, relative as relative3 } from "path";
 // 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: {
@@ -18880,7 +18902,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",
@@ -19064,18 +19086,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 = [
   {
@@ -19123,7 +19156,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",
@@ -19139,7 +19172,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.")
     })
   },
   {
@@ -19160,7 +19197,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",
@@ -19172,7 +19209,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",
@@ -19289,8 +19335,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,
@@ -19298,28 +19344,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.")
     })
   },
   {
@@ -19414,13 +19465,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",
@@ -19753,8 +19816,8 @@ import {
   existsSync as existsSync12,
   mkdirSync as mkdirSync9,
   readFileSync as readFileSync11,
-  readdirSync as readdirSync5,
-  statSync as statSync4,
+  readdirSync as readdirSync6,
+  statSync as statSync5,
   writeFileSync as writeFileSync8
 } from "fs";
 import { dirname as dirname6, join as join12, normalize as normalize3, relative as relative4, sep } from "path";
@@ -20216,9 +20279,9 @@ function parsePositiveInteger(value) {
 }
 function walkFiles2(dir) {
   const files = [];
-  for (const entry of readdirSync5(dir)) {
+  for (const entry of readdirSync6(dir)) {
     const full = join12(dir, entry);
-    const stats = statSync4(full);
+    const stats = statSync5(full);
     if (stats.isDirectory())
       files.push(...walkFiles2(full));
     else

package/dist/lib/compact-output.d.ts

@@ -0,0 +1,32 @@
+export declare const DEFAULT_LIST_LIMIT = 30;
+export declare const DEFAULT_SEARCH_LIMIT = 20;
+export declare const DEFAULT_TAG_LIMIT = 80;
+export declare const DEFAULT_MCP_LIMIT = 25;
+export declare const MAX_PAGE_LIMIT = 200;
+export declare const DEFAULT_PREVIEW_CHARS = 600;
+export interface Page<T> {
+    items: T[];
+    total: number;
+    offset: number;
+    limit: number;
+    hasMore: boolean;
+    nextOffset: number | null;
+}
+export declare function truncateText(value: unknown, maxChars?: number): string;
+export declare function previewText(value: unknown, maxChars?: number): {
+    text: string;
+    length: number;
+    truncated: boolean;
+};
+export declare function parsePageLimit(value: string | number | undefined, fallback: number, options?: {
+    max?: number;
+    allowAll?: boolean;
+}): number;
+export declare function parsePageOffset(value: string | number | undefined, fallback?: number): number;
+export declare function paginate<T>(items: T[], options: {
+    limit: number;
+    offset?: number;
+}): Page<T>;
+export declare function showingLabel(total: number, shown: number, offset: number): string;
+export declare function compactRunRecord(run: any): Record<string, unknown>;
+export declare function compactRemoteRun(run: any): Record<string, unknown>;

package/dist/lib/config.d.ts

@@ -19,7 +19,7 @@ export type ConfigScope = "global" | "project";
 /**
  * Get the data directory for skills global config/data.
  * New default: ~/.hasna/skills/
- * Auto-migrates from ~/.skillsrc if the new config doesn't exist yet.
+ * Auto-migrates from ~/.skills/ and ~/.skillsrc without deleting legacy data.
  */
 export declare function getDataDir(): string;
 /**

package/dist/lib/skill-aliases.d.ts

@@ -11,6 +11,7 @@ export declare const SKILL_ALIASES: {
     readonly "generate-image": "image";
     readonly "image-generator": "image";
     readonly "create-blog-article": "blog-article";
+    readonly "skill-diff": "diff-viewer";
 };
 export type SkillAlias = keyof typeof SKILL_ALIASES;
 export declare function normalizeSkillSlug(name: string): string;

package/dist/storage.js

@@ -20,14 +20,14 @@ import {
   existsSync as existsSync3,
   mkdirSync as mkdirSync3,
   readFileSync as readFileSync3,
-  readdirSync,
-  statSync,
+  readdirSync as readdirSync2,
+  statSync as statSync2,
   writeFileSync as writeFileSync3
 } from "fs";
 import { dirname as dirname2, join as join3, normalize, relative, sep } from "path";
 
 // 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";
 var ENUM_KEYS = {
@@ -53,6 +53,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;
@@ -76,14 +94,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) {
@@ -743,9 +764,9 @@ function parsePositiveInteger(value) {
 }
 function walkFiles(dir) {
   const files = [];
-  for (const entry of readdirSync(dir)) {
+  for (const entry of readdirSync2(dir)) {
     const full = join3(dir, entry);
-    const stats = statSync(full);
+    const stats = statSync2(full);
     if (stats.isDirectory())
       files.push(...walkFiles(full));
     else

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/skills",
-  "version": "0.1.46",
+  "version": "0.1.48",
   "description": "Skills library for AI coding agents",
   "type": "module",
   "bin": {
@@ -69,7 +69,7 @@
     "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",