@hasna/skills 0.1.21 → 0.1.23

package/dist/index.d.ts

@@ -7,7 +7,7 @@
  * Or use the interactive CLI:
  *   skills
  */
-export { SKILLS, CATEGORIES, getSkill, getSkillsByCategory, searchSkills, getSkillsByTag, getAllTags, findSimilarSkills, loadRegistry, clearRegistryCache, type SkillMeta, type Category, } from "./lib/registry.js";
+export { SKILLS, BASIC_SKILL_NAMES, CATEGORIES, getSkill, getSkillsByCategory, searchSkills, getSkillsByTag, getAllTags, findSimilarSkills, isBasicSkillName, loadRegistry, loadBasicRegistry, loadRegistryProfile, clearRegistryCache, type SkillMeta, type Category, type SkillRegistryProfile, } from "./lib/registry.js";
 export { installSkill, installSkills, installSkillForAgent, removeSkillForAgent, getInstalledSkills, removeSkill, skillExists, getSkillPath, getAgentSkillsDir, getAgentSkillPath, AGENT_TARGETS, type InstallResult, type InstallOptions, type AgentTarget, type AgentScope, type AgentInstallOptions, getInstallMeta, disableSkill, enableSkill, getDisabledSkills, } from "./lib/installer.js";
 export { getSkillDocs, getSkillBestDoc, getSkillRequirements, runSkill, generateEnvExample, generateSkillMd, type SkillDocs, type SkillRequirements, } from "./lib/skillinfo.js";
 export { loadConfig, saveConfig, getConfigPath, type SkillsConfig, type ConfigScope, } from "./lib/config.js";

package/dist/index.js

@@ -44,12 +44,12 @@ function fuzzyMatchScore(word, target) {
   }
   return 0;
 }
-function searchSkills(query) {
+function searchSkills(query, registry = loadRegistry()) {
   const words = query.toLowerCase().split(/\s+/).filter(Boolean);
   if (words.length === 0)
     return [];
   const scored = [];
-  for (const skill of loadRegistry()) {
+  for (const skill of registry) {
     const nameLower = skill.name.toLowerCase();
     const displayNameLower = skill.displayName.toLowerCase();
     const descriptionLower = skill.description.toLowerCase();
@@ -84,9 +84,9 @@ function searchSkills(query) {
   scored.sort((a, b) => b.score - a.score);
   return scored.map((s) => s.skill);
 }
-function findSimilarSkills(query, maxResults = 3) {
+function findSimilarSkills(query, maxResults = 3, registry = loadRegistry()) {
   const q = query.toLowerCase();
-  const scored = loadRegistry().map((s) => ({ name: s.name, dist: editDistance(q, s.name.toLowerCase()) })).filter((s) => s.dist <= Math.max(3, Math.floor(q.length / 2))).sort((a, b) => a.dist - b.dist);
+  const scored = registry.map((s) => ({ name: s.name, dist: editDistance(q, s.name.toLowerCase()) })).filter((s) => s.dist <= Math.max(3, Math.floor(q.length / 2))).sort((a, b) => a.dist - b.dist);
   return scored.slice(0, maxResults).map((s) => s.name);
 }
 
@@ -110,6 +110,28 @@ var CATEGORIES = [
   "Travel & Lifestyle",
   "Event Management"
 ];
+var BASIC_SKILL_NAMES = [
+  "image",
+  "video",
+  "audio",
+  "music",
+  "sound-effects",
+  "transcript",
+  "audio-extract",
+  "read-image",
+  "read-pdf",
+  "pdf-read",
+  "doc-read",
+  "pdf-generate",
+  "doc-generate",
+  "read-csv",
+  "read-excel",
+  "excel",
+  "convert"
+];
+function isBasicSkillName(name) {
+  return BASIC_SKILL_NAMES.includes(name.replace(/^skill-/, ""));
+}
 var SKILLS = [
   {
     name: "api-test-suite",
@@ -697,9 +719,9 @@ var SKILLS = [
   {
     name: "audio",
     displayName: "Audio",
-    description: "Generate audio, voiceovers, and speech using AI-powered TTS APIs (ElevenLabs, OpenAI)",
+    description: "Generate audio, voiceovers, and speech using AI-powered TTS APIs (Minimax, ElevenLabs, OpenAI)",
     category: "Content Generation",
-    tags: ["audio", "tts", "speech", "ai"]
+    tags: ["audio", "tts", "speech", "ai", "minimax"]
   },
   {
     name: "audiobook-chapter-proofer",
@@ -723,22 +745,22 @@ var SKILLS = [
     tags: ["diagrams", "flowcharts", "visualization", "architecture"]
   },
   {
-    name: "generate-docx",
-    displayName: "Generate DOCX",
-    description: "Generate DOCX documents with formatted content and styling",
+    name: "doc-generate",
+    displayName: "Doc Generate",
+    description: "Generate DOCX documents with rich formatting, templates, and AI content",
     category: "Content Generation",
     tags: ["docx", "document", "word", "generation"]
   },
   {
-    name: "generate-excel",
-    displayName: "Generate Excel",
-    description: "Generate Excel spreadsheets with formatted data, formulas, and charts",
+    name: "excel",
+    displayName: "Excel",
+    description: "Generate Excel spreadsheets with data, formulas, and professional styling",
     category: "Content Generation",
     tags: ["excel", "spreadsheet", "generation", "data"]
   },
   {
-    name: "generate-pdf",
-    displayName: "Generate PDF",
+    name: "pdf-generate",
+    displayName: "PDF Generate",
     description: "Generate PDF documents with rich formatting and layouts",
     category: "Content Generation",
     tags: ["pdf", "document", "generation", "formatting"]
@@ -767,23 +789,23 @@ var SKILLS = [
   {
     name: "image",
     displayName: "Image",
-    description: "Generate images using multiple AI providers: DALL-E 3, Imagen 3, and Aurora",
+    description: "Generate images using AI providers: Minimax, DALL-E 3, Imagen 3, and Aurora",
     category: "Content Generation",
-    tags: ["image", "generation", "ai", "dalle"]
+    tags: ["image", "generation", "ai", "minimax", "dalle"]
   },
   {
-    name: "jingle-composer",
-    displayName: "Jingle Composer",
-    description: "Compose advertising jingles and short musical pieces for brands",
+    name: "music",
+    displayName: "Music",
+    description: "Generate music tracks using AI models (Minimax Music-01)",
     category: "Content Generation",
-    tags: ["jingle", "music", "composition", "advertising"]
+    tags: ["music", "generation", "ai", "minimax"]
   },
   {
     name: "video",
     displayName: "Video",
-    description: "Generate videos using AI models from Google Veo, OpenAI Sora, and Runway",
+    description: "Generate videos using AI models: Minimax, Google Veo, OpenAI Sora, and Runway",
     category: "Content Generation",
-    tags: ["video", "generation", "ai", "sora"]
+    tags: ["video", "generation", "ai", "minimax", "sora"]
   },
   {
     name: "voiceover-casting-assistant",
@@ -1002,6 +1024,20 @@ var SKILLS = [
     category: "Data & Analysis",
     tags: ["pdf", "documents", "extraction", "analysis"]
   },
+  {
+    name: "pdf-read",
+    displayName: "PDF Read",
+    description: "Read multiple PDFs with page-range selection, chunked reading, and parallel processing",
+    category: "Data & Analysis",
+    tags: ["pdf", "reader", "extraction", "parallel"]
+  },
+  {
+    name: "doc-read",
+    displayName: "Doc Read",
+    description: "Read and extract text from DOCX files with section parsing and metadata extraction",
+    category: "Data & Analysis",
+    tags: ["docx", "reader", "extraction", "word"]
+  },
   {
     name: "spreadsheet-cleanroom",
     displayName: "Spreadsheet Cleanroom",
@@ -1031,8 +1067,8 @@ var SKILLS = [
     tags: ["video", "compression", "ffmpeg", "optimization"]
   },
   {
-    name: "extract-audio",
-    displayName: "Extract Audio",
+    name: "audio-extract",
+    displayName: "Audio Extract",
     description: "Extract audio tracks from video files with multiple format support",
     category: "Media Processing",
     tags: ["audio", "extraction", "video", "conversion"]
@@ -1107,6 +1143,13 @@ var SKILLS = [
     category: "Media Processing",
     tags: ["watermark", "protection", "copyright", "images"]
   },
+  {
+    name: "sound-effects",
+    displayName: "Sound Effects",
+    description: "Generate realistic sound effects from text descriptions using AI (Minimax)",
+    category: "Media Processing",
+    tags: ["audio", "sound-effects", "sfx", "ai", "minimax"]
+  },
   {
     name: "brand-style-guide",
     displayName: "Brand Style Guide",
@@ -1680,6 +1723,14 @@ function loadRegistry(cwd) {
   _registryCacheTime = now;
   return _registryCache;
 }
+function loadBasicRegistry(cwd) {
+  const registry = loadRegistry(cwd);
+  const byName = new Map(registry.map((skill) => [skill.name, skill]));
+  return BASIC_SKILL_NAMES.map((name) => byName.get(name)).filter((skill) => skill !== undefined);
+}
+function loadRegistryProfile(profile = "basic", cwd) {
+  return profile === "all" ? loadRegistry(cwd) : loadBasicRegistry(cwd);
+}
 function clearRegistryCache() {
   _registryCache = null;
   _registryCacheTime = 0;
@@ -2565,9 +2616,12 @@ export {
   removeSkill,
   removeSchedule,
   recordScheduleRun,
+  loadRegistryProfile,
   loadRegistry,
   loadConfig,
+  loadBasicRegistry,
   listSchedules,
+  isBasicSkillName,
   installSkills,
   installSkillForAgent,
   installSkill,
@@ -2596,5 +2650,6 @@ export {
   addSchedule,
   SKILLS,
   CATEGORIES,
+  BASIC_SKILL_NAMES,
   AGENT_TARGETS
 };

package/dist/lib/basic-skills.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/registry.d.ts

@@ -12,6 +12,9 @@ export interface SkillMeta {
 }
 export declare const CATEGORIES: readonly ["Development Tools", "Business & Marketing", "Productivity & Organization", "Project Management", "Content Generation", "Finance & Compliance", "Data & Analysis", "Media Processing", "Design & Branding", "Web & Browser", "Research & Writing", "Science & Academic", "Education & Learning", "Communication", "Health & Wellness", "Travel & Lifestyle", "Event Management"];
 export type Category = (typeof CATEGORIES)[number];
+export declare const BASIC_SKILL_NAMES: readonly ["image", "video", "audio", "music", "sound-effects", "transcript", "audio-extract", "read-image", "read-pdf", "pdf-read", "doc-read", "pdf-generate", "doc-generate", "read-csv", "read-excel", "excel", "convert"];
+export type SkillRegistryProfile = "basic" | "all";
+export declare function isBasicSkillName(name: string): boolean;
 export declare const SKILLS: SkillMeta[];
 /**
  * Load the full registry: official skills merged with custom skills from:
@@ -23,6 +26,8 @@ export declare const SKILLS: SkillMeta[];
  * Results are cached for 5 seconds.
  */
 export declare function loadRegistry(cwd?: string): SkillMeta[];
+export declare function loadBasicRegistry(cwd?: string): SkillMeta[];
+export declare function loadRegistryProfile(profile?: SkillRegistryProfile, cwd?: string): SkillMeta[];
 /** Invalidate the registry cache (e.g. after installing a custom skill). */
 export declare function clearRegistryCache(): void;
 export declare function getSkillsByCategory(category: Category): SkillMeta[];

package/dist/lib/search.d.ts

@@ -10,8 +10,8 @@ export declare function editDistance(a: string, b: string): number;
 /**
  * Search skills by name, description, and tags using fuzzy matching.
  */
-export declare function searchSkills(query: string): SkillMeta[];
+export declare function searchSkills(query: string, registry?: SkillMeta[]): SkillMeta[];
 /**
  * Find skills with names similar to the given query (for "did you mean?" suggestions).
  */
-export declare function findSimilarSkills(query: string, maxResults?: number): string[];
+export declare function findSimilarSkills(query: string, maxResults?: number, registry?: SkillMeta[]): string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/skills",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "description": "Skills library for AI coding agents",
   "type": "module",
   "bin": {

package/skills/skill-academic-journal-matcher/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-academic-journal-matcher.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-action-item-router/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-action-item-router.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-ad-creative-generator/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-ad-creative-generator.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-advanced-math/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-advanced-math.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-anomaly-investigator/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-anomaly-investigator.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-api-test-suite/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-api-test-suite.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-apidocs/package.json

@@ -11,12 +11,6 @@
     "build": "bun build bin/cli.ts --outdir dist --target node",
     "typecheck": "tsc --noEmit"
   },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-apidocs.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0",
   "keywords": [
     "api",
     "documentation",

package/skills/skill-audio/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: Audio Generation
+name: audio
 description: Generate high-quality audio using ElevenLabs, OpenAI TTS, and Google Text-to-Speech APIs. Support for text-to-speech, voice cloning, multiple languages, and various voice options.
 ---
 
@@ -7,6 +7,8 @@ description: Generate high-quality audio using ElevenLabs, OpenAI TTS, and Googl
 
 This skill provides a unified interface for generating audio from text using multiple AI-powered text-to-speech providers.
 
+This CLI is API-backed. Set `SKILL_API_KEY` when routing through the hosted skills/connectors runtime; provider-specific keys are managed by that runtime.
+
 ## Supported Providers
 
 ### ElevenLabs

package/skills/skill-audio/package.json

@@ -21,15 +21,10 @@
     "ai"
   ],
   "author": "",
-  "license": "Apache-2.0",
   "devDependencies": {
     "@types/bun": "latest"
   },
   "peerDependencies": {
     "typescript": "^5.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/hasnaxyz/skill-audio.git"
   }
 }

package/skills/skill-audio/src/index-local.ts

@@ -20,6 +20,7 @@ if (await handleInstallCommand(SKILL_META, process.argv.slice(2))) {
   process.exit(0);
 }
 
+import { MinimaxProvider } from './providers/minimax';
 import { ElevenLabsProvider } from './providers/elevenlabs';
 import { OpenAIProvider } from './providers/openai';
 import { GoogleProvider } from './providers/google';
@@ -56,6 +57,8 @@ function parseArgs(): {
 // Get provider instance
 function getProvider(providerName: Provider): AudioProvider {
   switch (providerName) {
+    case 'minimax':
+      return new MinimaxProvider();
     case 'elevenlabs':
       return new ElevenLabsProvider();
     case 'openai':
@@ -64,7 +67,7 @@ function getProvider(providerName: Provider): AudioProvider {
       return new GoogleProvider();
     default:
       throw new Error(
-        `Unknown provider: ${providerName}. Use: elevenlabs, openai, or google`
+        `Unknown provider: ${providerName}. Use: minimax, elevenlabs, openai, or google`
       );
   }
 }

package/skills/skill-audio/src/providers/minimax.ts

@@ -0,0 +1,83 @@
+import type { AudioProvider, GenerateOptions, Voice } from '../types';
+import { writeFile } from 'fs/promises';
+
+export class MinimaxProvider implements AudioProvider {
+  name = 'Minimax Speech-02-HD';
+  private apiKey: string;
+  private baseUrl = 'https://api.minimax.chat/v1';
+
+  constructor() {
+    this.apiKey = process.env.MINIMAX_API_KEY || '';
+    if (!this.apiKey) {
+      throw new Error('MINIMAX_API_KEY environment variable is required');
+    }
+  }
+
+  async generate(options: GenerateOptions): Promise<void> {
+    console.log(`Generating audio with ${this.name}...`);
+
+    const body: Record<string, unknown> = {
+      model: options.model || 'speech-02-hd',
+      text: options.text,
+    };
+
+    if (options.voice || options.speed) {
+      const voiceSetting: Record<string, unknown> = {};
+      if (options.voice) voiceSetting.voice_id = options.voice;
+      if (options.speed) voiceSetting.speed = options.speed;
+      body.voice_setting = voiceSetting;
+    }
+
+    const format = options.output.endsWith('.wav') ? 'wav' :
+                   options.output.endsWith('.flac') ? 'flac' : 'mp3';
+    body.audio_setting = { format };
+
+    if (options.language) {
+      body.language_boost = options.language;
+    }
+
+    const response = await fetch(`${this.baseUrl}/t2a_v2`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${this.apiKey}`,
+      },
+      body: JSON.stringify(body),
+    });
+
+    if (!response.ok) {
+      const err = await response.text();
+      throw new Error(`Minimax API error: ${response.status} - ${err}`);
+    }
+
+    const data = await response.json() as {
+      data?: { audio?: string };
+      base_resp?: { status_code: number; status_msg: string };
+    };
+
+    if (data.base_resp && data.base_resp.status_code !== 0) {
+      throw new Error(`Minimax TTS error: ${data.base_resp.status_msg}`);
+    }
+
+    if (!data.data?.audio) {
+      throw new Error('No audio data in response');
+    }
+
+    const audioBuffer = Buffer.from(data.data.audio, 'hex');
+    await writeFile(options.output, audioBuffer);
+    console.log(`Audio saved to: ${options.output}`);
+  }
+
+  async listVoices(): Promise<Voice[]> {
+    return [
+      { id: 'male-qn-qingse', name: 'Qingse (Male)', description: 'Young male, clear voice' },
+      { id: 'female-shaonv', name: 'Shaonv (Female)', description: 'Young female voice' },
+      { id: 'female-yujie', name: 'Yujie (Female)', description: 'Mature female voice' },
+      { id: 'male-qn-jingying', name: 'Jingying (Male)', description: 'Male elite voice' },
+      { id: 'presenter_male', name: 'Presenter Male', description: 'Professional male presenter' },
+      { id: 'presenter_female', name: 'Presenter Female', description: 'Professional female presenter' },
+      { id: 'audiobook_male_1', name: 'Audiobook Male', description: 'Audiobook narrator male' },
+      { id: 'audiobook_female_1', name: 'Audiobook Female', description: 'Audiobook narrator female' },
+    ];
+  }
+}

package/skills/skill-audio/src/types.ts

@@ -2,7 +2,7 @@
  * Shared types and interfaces for audio generation providers
  */
 
-export type Provider = 'elevenlabs' | 'openai' | 'google';
+export type Provider = 'minimax' | 'elevenlabs' | 'openai' | 'google';
 
 export interface GenerateOptions {
   text: string;

package/skills/skill-audio-cleanup-lab/package.json

@@ -19,9 +19,5 @@
     "src",
     "dist",
     "SKILL.md"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/hasnaxyz/skill-audio-cleanup-lab.git"
-  }
+  ]
 }

package/skills/{skill-extract-audio → skill-audio-extract}/SKILL.md

@@ -1,9 +1,9 @@
 ---
-name: Extract Audio
+name: audio-extract
 version: 0.1.0
 description: Extract audio tracks from video files using FFmpeg with format conversion options
 author: skills.md
-category: Design & Creative
+category: Media Processing
 tags:
   - audio
   - video
@@ -70,4 +70,4 @@ skills run extract-audio -- lecture_recording.mkv --format mp3 --quality low
 ## Requirements
 
 - FFmpeg installed and in PATH.
-- Bun runtime.
+- Bun runtime.

package/skills/{skill-extract-audio → skill-audio-extract}/package.json

@@ -1,9 +1,9 @@
 {
-  "name": "@hasnaxyz/skill-extract-audio",
+  "name": "@hasnaxyz/skill-audio-extract",
   "version": "0.1.0",
   "type": "module",
   "bin": {
-    "skill-extract-audio": "./src/index.ts"
+    "skill-audio-extract": "./src/index.ts"
   },
   "scripts": {
     "dev": "bun run src/index.ts",
@@ -19,9 +19,5 @@
     "src",
     "dist",
     "SKILL.md"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-extract-audio.git"
-  }
+  ]
 }

package/skills/skill-audiobook-chapter-proofer/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-audiobook-chapter-proofer.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-banner-ad-suite/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-banner-ad-suite.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-benchmark-finder/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-benchmark-finder.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-bio-sequence-tool/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-bio-sequence-tool.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-blog-topic-cluster/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-blog-topic-cluster.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-brand-voice-audit/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-brand-voice-audit.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }