@hasna/skills 0.1.22 → 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",
@@ -1219,13 +1241,6 @@ var SKILLS = [
     category: "Design & Branding",
     tags: ["design", "shadcn", "tailwind", "colors", "typography", "playwright", "analysis", "open-styles"]
   },
-  {
-    name: "logo-design",
-    displayName: "Logo Design",
-    description: "Generate professional logos using AI providers (OpenAI GPT Image, Google Gemini Nano Banana) via connectors REST API",
-    category: "Design & Branding",
-    tags: ["logo", "design", "branding", "ai", "openai", "gemini", "connectors"]
-  },
   {
     name: "browse",
     displayName: "Browse",
@@ -1708,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;
@@ -2593,9 +2616,12 @@ export {
   removeSkill,
   removeSchedule,
   recordScheduleRun,
+  loadRegistryProfile,
   loadRegistry,
   loadConfig,
+  loadBasicRegistry,
   listSchedules,
+  isBasicSkillName,
   installSkills,
   installSkillForAgent,
   installSkill,
@@ -2624,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.22",
+  "version": "0.1.23",
   "description": "Skills library for AI coding agents",
   "type": "module",
   "bin": {

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-extract/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: Audio Extract
+name: audio-extract
 version: 0.1.0
 description: Extract audio tracks from video files using FFmpeg with format conversion options
 author: skills.md
@@ -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-convert/SKILL.md

@@ -1,9 +1,16 @@
+---
+name: convert
+description: File format conversion and transformation CLI between images, PDFs, documents, CSV, and data formats.
+---
+
 # skill-convert
 
 ## Description
 
 File format conversion skill with AI-powered extraction capabilities. Converts between images, PDFs, documents, and data formats with optional quality control and AI cleanup.
 
+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.
+
 ## Category
 
 File Processing / Format Conversion

package/skills/skill-doc-generate/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: Generate Docx
+name: doc-generate
 version: 1.0.0
 description: Generate docx with customizable options
 author: skills.md
@@ -292,4 +292,4 @@ export OPENAI_API_KEY="sk-..."
 
 For issues or feature requests, visit [skills.md/skills/generate-docx](https://skills.md/skills/generate-docx)
 
-```
+```

package/skills/skill-doc-generate/package.json

@@ -11,7 +11,12 @@
     "dev": "bun run --watch src/index.ts",
     "cli": "bun run src/index.ts"
   },
-  "dependencies": {},
+  "dependencies": {
+    "docx": "^9.5.1",
+    "marked": "^15.0.4",
+    "minimist": "^1.2.8",
+    "openai": "^4.77.0"
+  },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "restricted"

package/skills/skill-doc-generate/src/index.ts

@@ -1,31 +1,92 @@
 #!/usr/bin/env bun
 
-import {
-  Document,
-  Packer,
-  Paragraph,
-  TextRun,
-  HeadingLevel,
-  Table,
-  TableRow,
-  TableCell,
-  WidthType,
-  AlignmentType,
-  BorderStyle,
-  PageNumber,
-  NumberFormat,
-  Header,
-  Footer,
-  TableOfContents,
-  ImageRun,
-  ExternalHyperlink,
-  PageBreak,
-} from "docx";
 import * as fs from "fs";
 import * as path from "path";
-import minimist from "minimist";
-import { marked } from "marked";
-import OpenAI from "openai";
+
+let Document: any;
+let Packer: any;
+let Paragraph: any;
+let TextRun: any;
+let HeadingLevel: any;
+let Table: any;
+let TableRow: any;
+let TableCell: any;
+let WidthType: any;
+let AlignmentType: any;
+let BorderStyle: any;
+let PageNumber: any;
+let NumberFormat: any;
+let Header: any;
+let Footer: any;
+let TableOfContents: any;
+let PageBreak: any;
+let marked: any;
+
+function printHelpAndExit(): never {
+  console.log(`
+Generate DOCX - Create Word documents from markdown or AI
+
+Usage:
+  skill-doc-generate <markdown-file> [options]
+  skill-doc-generate --topic "Topic" [options]
+  skill-doc-generate --prompt "Prompt" [options]
+
+Input Options:
+  <file>              Input markdown file
+  --topic <text>      Topic for AI to write about
+  --prompt <text>     Direct prompt for AI generation
+  --text <text>       Plain text content
+
+Output Options:
+  -o, --output <path> Output file path
+  --dir <path>        Output directory (default: .skills/exports)
+  --template <name>   Template: default, report, letter, memo, resume, article
+  --help, -h          Show this help
+`);
+  process.exit(0);
+}
+
+if (process.argv.includes("--help") || process.argv.includes("-h")) {
+  printHelpAndExit();
+}
+
+async function loadDocumentDeps(): Promise<void> {
+  if (Document && marked) return;
+  try {
+    const docx = await import("docx");
+    Document = docx.Document;
+    Packer = docx.Packer;
+    Paragraph = docx.Paragraph;
+    TextRun = docx.TextRun;
+    HeadingLevel = docx.HeadingLevel;
+    Table = docx.Table;
+    TableRow = docx.TableRow;
+    TableCell = docx.TableCell;
+    WidthType = docx.WidthType;
+    AlignmentType = docx.AlignmentType;
+    BorderStyle = docx.BorderStyle;
+    PageNumber = docx.PageNumber;
+    NumberFormat = docx.NumberFormat;
+    Header = docx.Header;
+    Footer = docx.Footer;
+    TableOfContents = docx.TableOfContents;
+    PageBreak = docx.PageBreak;
+    ({ marked } = await import("marked"));
+  } catch {
+    throw new Error("Missing document generation dependencies. Run bun install in this skill directory.");
+  }
+}
+
+async function createOpenAIClient(apiKey: string) {
+  try {
+    const { default: OpenAI } = await import("openai");
+    return new OpenAI({ apiKey });
+  } catch {
+    throw new Error("Missing dependency 'openai'. Run bun install in this skill directory.");
+  }
+}
+
+const minimist = (await import("minimist")).default;
 
 // Types
 interface DocOptions {
@@ -190,7 +251,7 @@ async function generateWithAI(topic: string, isPrompt: boolean = false): Promise
     throw new Error("OPENAI_API_KEY environment variable is required for AI generation");
   }
 
-  const openai = new OpenAI({ apiKey });
+  const openai = await createOpenAIClient(apiKey);
 
   const lengthGuide = {
     short: "Keep it concise, around 500 words total.",
@@ -377,8 +438,8 @@ function parseMarkdown(markdown: string): ParsedContent {
 }
 
 // Parse inline formatting
-function parseInlineFormatting(text: string): TextRun[] {
-  const runs: TextRun[] = [];
+function parseInlineFormatting(text: string): any[] {
+  const runs: any[] = [];
   let remaining = text;
 
   // Simple regex-based parsing for bold, italic, code
@@ -429,7 +490,7 @@ function getPageSize(size: string): { width: number; height: number } {
 }
 
 // Build document from parsed content
-function buildDocument(content: ParsedContent): Document {
+function buildDocument(content: ParsedContent): any {
   const pageSize = getPageSize(options.pageSize);
   const marginTwips = options.margins * 1440; // Convert inches to twips
 
@@ -698,6 +759,8 @@ async function main(): Promise<void> {
       process.exit(1);
     }
 
+    await loadDocumentDeps();
+
     // Parse content
     console.log("Parsing content...");
     const content = parseMarkdown(markdown);

package/skills/skill-doc-read/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: Doc Read
+name: doc-read
 version: 0.1.0
 description: Read and extract text from DOCX files with section parsing, metadata extraction, and multiple file support
 category: Data & Analysis

package/skills/skill-doc-read/package.json

@@ -11,7 +11,9 @@
     "build": "bun build src/index.ts --outdir dist --target node",
     "typecheck": "tsc --noEmit"
   },
-  "dependencies": {},
+  "dependencies": {
+    "jszip": "^3.10.1"
+  },
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5.7.0"

package/skills/skill-doc-read/src/index.ts

@@ -4,7 +4,14 @@ import { readFile, writeFile, stat, mkdir } from 'fs/promises';
 import { existsSync } from 'fs';
 import { basename, extname, dirname, resolve } from 'path';
 import { parseArgs } from 'util';
-import JSZip from 'jszip';
+
+async function loadJSZip() {
+  try {
+    return (await import('jszip')).default;
+  } catch {
+    throw new Error("Missing dependency 'jszip'. Run bun install in this skill directory.");
+  }
+}
 
 interface DocResult {
   file: string;
@@ -32,6 +39,7 @@ interface DocMetadata {
 }
 
 async function extractDocxText(buffer: Buffer): Promise<{ text: string; sections: DocSection[] }> {
+  const JSZip = await loadJSZip();
   const zip = await JSZip.loadAsync(buffer);
 
   const documentXml = await zip.file('word/document.xml')?.async('string');
@@ -89,6 +97,7 @@ async function extractDocxText(buffer: Buffer): Promise<{ text: string; sections
 }
 
 async function extractDocxMetadata(buffer: Buffer): Promise<DocMetadata> {
+  const JSZip = await loadJSZip();
   const zip = await JSZip.loadAsync(buffer);
 
   const coreXml = await zip.file('docProps/core.xml')?.async('string');

package/skills/skill-excel/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: excel
+version: 0.1.0
+description: Generate Excel spreadsheets with tables, formulas, multiple sheets, styling, and optional AI-generated data.
+category: Content Generation
+tags:
+  - excel
+  - spreadsheet
+  - xlsx
+  - generation
+  - data
+---
+
+# Excel
+
+Generate `.xlsx` spreadsheets or CSV exports from templates, prompt-provided data, or AI-generated sample data. Use this when the user needs a workbook, budget, invoice sheet, report table, tracker, or structured spreadsheet file.
+
+## Usage
+
+```bash
+skill-excel --preset budget --rows 12 --output ./budget.xlsx
+skill-excel --prompt "Create a weekly content calendar" --output ./calendar.xlsx
+skill-excel --format csv --preset invoice --output ./invoice.csv
+```
+
+## Inputs
+
+- `--preset <name>`: use a built-in workbook template such as `budget`, `invoice`, or `tracker`
+- `--prompt <text>`: ask AI to generate spreadsheet data
+- `--rows <n>`: number of rows to create
+- `--sheets <names>`: comma-separated sheet names
+- `--format <xlsx|csv>`: output format
+- `--output <path>`: output file path
+
+## Requirements
+
+- `OPENAI_API_KEY` is required only when using prompt-based AI data generation.
+- Local template generation does not need network access.

package/skills/skill-excel/package.json

@@ -11,7 +11,10 @@
     "build": "bun build src/index.ts --outdir dist --target node",
     "typecheck": "tsc --noEmit"
   },
-  "dependencies": {},
+  "dependencies": {
+    "openai": "^4.77.0",
+    "xlsx": "^0.18.5"
+  },
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5.7.0"

package/skills/skill-excel/src/index.ts

@@ -1,11 +1,15 @@
 #!/usr/bin/env bun
-import * as XLSX from "xlsx";
 import { parseArgs } from "util";
 import { existsSync, mkdirSync, appendFileSync } from "fs";
 import { join } from "path";
-import OpenAI from "openai";
 import { randomUUID } from "crypto";
 
+type XlsxModule = typeof import("xlsx");
+type WorkSheet = import("xlsx").WorkSheet;
+type WorkBook = import("xlsx").WorkBook;
+
+let XLSX: XlsxModule;
+
 const SKILL_NAME = "generate-excel";
 const SESSION_ID = randomUUID().slice(0, 8);
 
@@ -37,11 +41,6 @@ function log(message: string, level: "info" | "error" | "success" | "warn" = "in
   }
 }
 
-// OpenAI client
-const openai = new OpenAI({
-  apiKey: process.env.OPENAI_API_KEY,
-});
-
 // Type definitions
 interface ExcelCell {
   v: any; // value
@@ -118,6 +117,23 @@ const TEMPLATES: Record<string, (rows: number) => SheetData> = {
   }),
 };
 
+async function loadXlsx(): Promise<XlsxModule> {
+  try {
+    return await import("xlsx");
+  } catch {
+    throw new Error("Missing dependency 'xlsx'. Run bun install in this skill directory.");
+  }
+}
+
+async function createOpenAIClient() {
+  try {
+    const { default: OpenAI } = await import("openai");
+    return new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
+  } catch {
+    throw new Error("Missing dependency 'openai'. Run bun install in this skill directory.");
+  }
+}
+
 // Data generators
 function generateBudgetData(rows: number): any[][] {
   const categories = [
@@ -297,6 +313,7 @@ Return a JSON object with:
 
 Generate exactly ${rows} rows of data. Make the data realistic and varied.`;
 
+  const openai = await createOpenAIClient();
   const response = await openai.chat.completions.create({
     model: "gpt-4o-mini",
     messages: [
@@ -341,7 +358,7 @@ function parseJsonData(jsonString: string): SheetData {
 
 // Apply styling to worksheet
 function applyStyles(
-  ws: XLSX.WorkSheet,
+  ws: WorkSheet,
   sheetData: SheetData,
   styling: "none" | "basic" | "professional"
 ) {
@@ -401,7 +418,7 @@ function applyStyles(
 
 // Add formulas to worksheet
 function addFormulas(
-  ws: XLSX.WorkSheet,
+  ws: WorkSheet,
   sheetData: SheetData,
   startRow: number = 2
 ) {
@@ -423,7 +440,7 @@ function addFormulas(
 
 // Add summary row with totals
 function addSummaryRow(
-  ws: XLSX.WorkSheet,
+  ws: WorkSheet,
   sheetData: SheetData
 ): void {
   const lastRow = sheetData.rows.length + 1;
@@ -458,7 +475,7 @@ function addSummaryRow(
 function createWorkbook(
   sheets: SheetData[],
   options: GenerateOptions
-): XLSX.WorkBook {
+): WorkBook {
   const wb = XLSX.utils.book_new();
 
   sheets.forEach((sheetData) => {
@@ -494,6 +511,12 @@ function createWorkbook(
 
 // Main function
 async function main() {
+  if (process.argv.includes("--help") || process.argv.includes("-h")) {
+    printHelpAndExit();
+  }
+
+  XLSX = await loadXlsx();
+
   const { values, positionals } = parseArgs({
     args: process.argv.slice(2),
     options: {
@@ -510,7 +533,11 @@ async function main() {
   });
 
   if (values.help) {
-    console.log(`
+    printHelpAndExit();
+  }
+
+function printHelpAndExit(): never {
+  console.log(`
 Generate Excel - Create Excel spreadsheets with data and formatting
 
 Usage:
@@ -526,8 +553,8 @@ Options:
   --output <path>      Output file path
   --help, -h           Show this help
 `);
-    process.exit(0);
-  }
+  process.exit(0);
+}
 
   const prompt = positionals[0];
 

package/skills/skill-image/SKILL.md

@@ -7,6 +7,8 @@ description: Generate images using AI providers (OpenAI DALL-E 3, Google Gemini
 
 Generate high-quality images from text prompts using multiple AI 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
 
 ### OpenAI

package/skills/skill-music/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: Music
+name: music
 version: 0.1.0
 description: Generate music tracks using AI models (Minimax Music-01)
 category: Content Generation

package/skills/skill-pdf-generate/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: Generate Pdf
+name: pdf-generate
 version: 0.1.0
 description: Generate high-quality PDF documents from markdown, HTML, or templates
 category: Productivity
@@ -83,4 +83,4 @@ skills run generate-pdf -- --file README.md \
 
 ## Requirements
 
-- Bun runtime.
+- Bun runtime.

package/skills/skill-pdf-generate/package.json

@@ -11,7 +11,9 @@
     "dev": "bun run --watch src/index.ts",
     "cli": "bun run src/index.ts"
   },
-  "dependencies": {},
+  "dependencies": {
+    "pdf-lib": "^1.17.1"
+  },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "restricted"