@hasna/skills 0.1.21 → 0.1.23

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

@@ -2,7 +2,11 @@
 
 import { mkdir, writeFile } from "fs/promises";
 import { dirname, resolve } from "path";
-import * as XLSX from "xlsx";
+
+type XlsxModule = typeof import("xlsx");
+type WorkBook = import("xlsx").WorkBook;
+type WorkSheet = import("xlsx").WorkSheet;
+type CellObject = import("xlsx").CellObject;
 
 const VERSION = "0.1.0";
 
@@ -39,6 +43,14 @@ interface WorkbookResult {
   sheets: SheetResult[];
 }
 
+async function loadXlsx(): Promise<XlsxModule> {
+  try {
+    return await import("xlsx");
+  } catch {
+    throw new Error("Missing dependency 'xlsx'. Run bun install in this skill directory.");
+  }
+}
+
 function printHelp(): void {
   console.log(`skill-read-excel v${VERSION}
 
@@ -141,7 +153,7 @@ function inferHeader(rows: unknown[][]): boolean {
   return unique.size === first.length && mostlyText && secondHasNumeric;
 }
 
-function collectFormattedCells(sheet: XLSX.WorkSheet, maxCells = 50): Array<{ cell: string; raw?: unknown; formatted?: string; format?: string }> {
+function collectFormattedCells(sheet: WorkSheet, maxCells = 50): Array<{ cell: string; raw?: unknown; formatted?: string; format?: string }> {
   const result: Array<{ cell: string; raw?: unknown; formatted?: string; format?: string }> = [];
   const entries = Object.entries(sheet).filter(([key]) => !key.startsWith("!"));
 
@@ -149,7 +161,7 @@ function collectFormattedCells(sheet: XLSX.WorkSheet, maxCells = 50): Array<{ ce
     if (result.length >= maxCells) {
       break;
     }
-    const cellValue = value as XLSX.CellObject;
+    const cellValue = value as CellObject;
     if (cellValue.z || cellValue.w) {
       result.push({
         cell,
@@ -163,8 +175,8 @@ function collectFormattedCells(sheet: XLSX.WorkSheet, maxCells = 50): Array<{ ce
   return result;
 }
 
-function parseSheet(name: string, index: number, sheet: XLSX.WorkSheet, limit?: number): SheetResult {
-  const rows = XLSX.utils.sheet_to_json(sheet, {
+function parseSheet(xlsx: XlsxModule, name: string, index: number, sheet: WorkSheet, limit?: number): SheetResult {
+  const rows = xlsx.utils.sheet_to_json(sheet, {
     header: 1,
     defval: null,
     raw: false,
@@ -198,7 +210,7 @@ function parseSheet(name: string, index: number, sheet: XLSX.WorkSheet, limit?:
   };
 }
 
-function collectNamedRanges(workbook: XLSX.WorkBook): NamedRange[] {
+function collectNamedRanges(workbook: WorkBook): NamedRange[] {
   const names = workbook.Workbook?.Names ?? [];
   return names.map((entry) => ({
     name: entry.Name ?? "",
@@ -214,8 +226,9 @@ async function writeJson(path: string, payload: WorkbookResult): Promise<void> {
 
 async function main(): Promise<void> {
   const options = parseArgs(process.argv.slice(2));
+  const xlsx = await loadXlsx();
   const inputPath = resolve(options.input!);
-  const workbook = XLSX.readFile(inputPath, {
+  const workbook = xlsx.readFile(inputPath, {
     cellDates: true,
     cellNF: true,
     cellStyles: true,
@@ -236,7 +249,7 @@ async function main(): Promise<void> {
       sheetNames: workbook.SheetNames,
       namedRanges: collectNamedRanges(workbook),
     },
-    sheets: selectedSheetNames.map((name) => parseSheet(name, workbook.SheetNames.indexOf(name), workbook.Sheets[name], options.limit)),
+    sheets: selectedSheetNames.map((name) => parseSheet(xlsx, name, workbook.SheetNames.indexOf(name), workbook.Sheets[name], options.limit)),
   };
 
   if (options.output) {

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

@@ -1,5 +1,5 @@
 ---
-name: skill-read-image
+name: read-image
 description: Analyze an image from a local path or URL with Claude vision. Supports prompt-controlled description, OCR, object counting, and brand/visual extraction.
 ---
 

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

@@ -22,7 +22,6 @@
     "claude",
     "skill"
   ],
-  "license": "Apache-2.0",
   "scripts": {
     "start": "bun run src/index.ts",
     "typecheck": "tsc --noEmit"

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

@@ -1,5 +1,5 @@
 ---
-name: skill-read-pdf
+name: read-pdf
 description: Analyze PDF files with Claude document blocks. Supports page-range selection, 20-page chunking, and merged structured output.
 ---
 

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

@@ -22,7 +22,6 @@
     "ocr",
     "skill"
   ],
-  "license": "Apache-2.0",
   "scripts": {
     "start": "bun run src/index.ts",
     "typecheck": "tsc --noEmit"

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

@@ -2,7 +2,6 @@
 
 import { mkdir, readFile, writeFile } from "fs/promises";
 import { dirname, resolve } from "path";
-import { PDFDocument } from "pdf-lib";
 
 const VERSION = "0.1.0";
 const DEFAULT_MODEL = process.env.ANTHROPIC_MODEL || "claude-sonnet-4-20250514";
@@ -11,6 +10,8 @@ const DEFAULT_PROMPT =
 const API_URL = process.env.ANTHROPIC_API_URL || "https://api.anthropic.com/v1/messages";
 const MAX_CHUNK_SIZE = 20;
 const MAX_REQUEST_BYTES = 32 * 1024 * 1024;
+type PdfLib = typeof import("pdf-lib");
+type LoadedPdfDocument = Awaited<ReturnType<PdfLib["PDFDocument"]["load"]>>;
 
 type OutputFormat = "json" | "markdown" | "text";
 
@@ -180,6 +181,14 @@ async function loadPdfBytes(input: string): Promise<{ input: string; bytes: Uint
   };
 }
 
+async function loadPdfLib(): Promise<PdfLib> {
+  try {
+    return await import("pdf-lib");
+  } catch {
+    throw new Error("Missing dependency 'pdf-lib'. Run bun install in this skill directory.");
+  }
+}
+
 function parsePageRanges(spec: string | undefined, totalPages: number): number[] {
   if (!spec) {
     return Array.from({ length: totalPages }, (_, index) => index + 1);
@@ -223,7 +232,8 @@ function chunkPages(pages: number[], size: number): number[][] {
   return chunks;
 }
 
-async function buildChunkPdf(sourcePdf: PDFDocument, pages: number[]): Promise<Uint8Array> {
+async function buildChunkPdf(pdfLib: PdfLib, sourcePdf: LoadedPdfDocument, pages: number[]): Promise<Uint8Array> {
+  const { PDFDocument } = pdfLib;
   const output = await PDFDocument.create();
   const copiedPages = await output.copyPages(sourcePdf, pages.map((page) => page - 1));
   for (const page of copiedPages) {
@@ -315,6 +325,8 @@ async function writeOutput(path: string, value: string): Promise<void> {
 
 async function main(): Promise<void> {
   const options = parseArgs(process.argv.slice(2));
+  const pdfLib = await loadPdfLib();
+  const { PDFDocument } = pdfLib;
   const { input, bytes } = await loadPdfBytes(options.input!);
   const sourcePdf = await PDFDocument.load(bytes);
   const totalPages = sourcePdf.getPageCount();
@@ -325,7 +337,7 @@ async function main(): Promise<void> {
 
   for (let index = 0; index < pageChunks.length; index += 1) {
     const pages = pageChunks[index];
-    const chunkPdf = await buildChunkPdf(sourcePdf, pages);
+    const chunkPdf = await buildChunkPdf(pdfLib, sourcePdf, pages);
     const prompt = [
       options.prompt,
       formatInstruction(options.format),

package/skills/skill-regex-tester/package.json

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

package/skills/skill-remove-background/package.json

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

package/skills/skill-risk-disclosure-kit/package.json

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

package/skills/skill-roi-comparison-tool/package.json

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

package/skills/skill-sales-call-recapper/package.json

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

package/skills/skill-scaffold-project/package.json

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

package/skills/skill-scancommitpr/package.json

@@ -21,8 +21,6 @@
     "claude-code",
     "skill"
   ],
-  "author": "Hasna",
-  "license": "Apache-2.0",
   "devDependencies": {
     "@types/bun": "latest"
   },

package/skills/skill-scancommitpush/package.json

@@ -19,8 +19,6 @@
     "claude-code",
     "skill"
   ],
-  "author": "Hasna",
-  "license": "Apache-2.0",
   "devDependencies": {
     "@types/bun": "latest"
   },

package/skills/skill-scholarship-tracker/package.json

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

package/skills/skill-scientific-figure-check/package.json

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

package/skills/skill-seating-chart-maker/package.json

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

package/skills/skill-security-audit/package.json

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

package/skills/skill-seo-brief-builder/package.json

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

package/skills/skill-siteanalyze/package.json

@@ -4,10 +4,24 @@
   "description": "Analyze any website's design system — detects shadcn/ui, Tailwind, extracts colors, typography, and components",
   "main": "src/index.ts",
   "type": "module",
-  "bin": { "skill-siteanalyze": "src/index.ts" },
-  "scripts": { "start": "bun run src/index.ts" },
-  "keywords": ["design", "shadcn", "tailwind", "colors", "typography", "playwright", "analysis", "open-styles"],
-  "license": "Apache-2.0",
+  "bin": {
+    "skill-siteanalyze": "src/index.ts"
+  },
+  "scripts": {
+    "start": "bun run src/index.ts"
+  },
+  "keywords": [
+    "design",
+    "shadcn",
+    "tailwind",
+    "colors",
+    "typography",
+    "playwright",
+    "analysis",
+    "open-styles"
+  ],
   "dependencies": {},
-  "devDependencies": { "@types/bun": "latest" }
+  "devDependencies": {
+    "@types/bun": "latest"
+  }
 }

package/skills/skill-slack-assistant/package.json

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

package/skills/skill-sleep-routine-analyzer/package.json

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

package/skills/skill-sms/package.json

@@ -23,7 +23,6 @@
     "agent"
   ],
   "author": "",
-  "license": "Apache-2.0",
   "devDependencies": {
     "@types/bun": "latest"
   },

package/skills/skill-social-media-kit/package.json

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

package/skills/skill-sound-effects/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: sound-effects
+version: 0.1.0
+description: Generate sound effects using AI models (Minimax)
+category: Media Processing
+tags:
+  - audio
+  - sound-effects
+  - sfx
+  - ai
+  - generation
+---
+
+# Sound Effects
+
+Generate realistic sound effects from text descriptions using AI. Describe any sound — thunder, footsteps, explosions, ambient noise — and get a high-quality audio file.
+
+## Features
+
+- **Text-to-SFX**: Describe any sound and get an audio file
+- **Duration Control**: Set the desired length of the sound effect
+- **Multiple Formats**: Output to MP3, WAV, or other audio formats
+
+## Usage
+
+```bash
+skill-sound-effects generate --prompt "thunder rolling in the distance" --output ./thunder.mp3
+skill-sound-effects generate --prompt "footsteps on gravel" --duration 5 --output ./steps.mp3
+skill-sound-effects generate --prompt "spaceship engine humming" --output ./engine.mp3
+```
+
+## Environment Variables
+
+- `MINIMAX_API_KEY` — API key for Minimax (required)

package/skills/{skill-jingle-composer → skill-sound-effects}/package.json

@@ -1,10 +1,10 @@
 {
-  "name": "@hasnaxyz/skill-jingle-composer",
+  "name": "@hasnaxyz/skill-sound-effects",
   "version": "0.1.0",
-  "description": "Jingle Composer skill",
+  "description": "Generate sound effects using AI (Minimax)",
   "type": "module",
   "bin": {
-    "skill-jingle-composer": "./src/index.ts"
+    "skill-sound-effects": "./src/index.ts"
   },
   "scripts": {
     "dev": "bun run src/index.ts",
@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-jingle-composer.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-sound-effects/src/index.ts

@@ -0,0 +1,172 @@
+#!/usr/bin/env bun
+
+import { writeFile, mkdir } from 'fs/promises';
+import { resolve, dirname } from 'path';
+import { handleInstallCommand } from '../../_common';
+
+const SKILL_META = {
+  name: 'skill-sound-effects',
+  description: 'Generate sound effects using AI (Minimax)',
+  version: '1.0.0',
+  commands: `Use: skill-sound-effects --help`,
+  requiredEnvVars: ['MINIMAX_API_KEY'],
+};
+
+if (await handleInstallCommand(SKILL_META, process.argv.slice(2))) {
+  process.exit(0);
+}
+
+type Provider = 'minimax';
+
+interface GenerateOptions {
+  provider: Provider;
+  prompt: string;
+  output: string;
+  duration?: number;
+}
+
+function parseArgs(): GenerateOptions | null {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+    printHelp();
+    return null;
+  }
+
+  if (args[0] !== 'generate') {
+    console.error(`Unknown command: ${args[0]}`);
+    process.exit(1);
+  }
+
+  const options: Partial<GenerateOptions> = { provider: 'minimax' };
+
+  for (let i = 1; i < args.length; i++) {
+    switch (args[i]) {
+      case '--provider': case '-p': options.provider = args[++i] as Provider; break;
+      case '--prompt': options.prompt = args[++i]; break;
+      case '--output': case '-o': options.output = args[++i]; break;
+      case '--duration': options.duration = parseInt(args[++i]); break;
+      default: console.error(`Unknown option: ${args[i]}`); process.exit(1);
+    }
+  }
+
+  if (!options.prompt) { console.error('Error: --prompt is required'); process.exit(1); }
+  if (!options.output) { console.error('Error: --output is required'); process.exit(1); }
+
+  return options as GenerateOptions;
+}
+
+function printHelp() {
+  console.log(`
+Sound Effects Generation Skill
+
+Generate sound effects using AI models (Minimax)
+
+USAGE:
+  skill-sound-effects generate [OPTIONS]
+
+OPTIONS:
+  --provider, -p <provider>   Provider (minimax) [default: minimax]
+  --prompt <text>             Description of the sound effect [required]
+  --output, -o <path>         Output file path [required]
+  --duration <seconds>        Duration in seconds
+
+EXAMPLES:
+  skill-sound-effects generate --prompt "thunder rolling" --output ./thunder.mp3
+  skill-sound-effects generate --prompt "footsteps on gravel" --duration 5 --output ./steps.mp3
+  skill-sound-effects generate --prompt "rain on a tin roof" --output ./rain.mp3
+
+ENVIRONMENT VARIABLES:
+  MINIMAX_API_KEY             API key for Minimax
+`);
+}
+
+async function generateMinimax(options: GenerateOptions): Promise<Buffer> {
+  const apiKey = process.env.MINIMAX_API_KEY;
+  if (!apiKey) throw new Error('MINIMAX_API_KEY environment variable is required');
+
+  const baseUrl = 'https://api.minimax.chat/v1';
+
+  console.log(`Generating sound effect with Minimax...`);
+  console.log(`Prompt: ${options.prompt}`);
+
+  const body: Record<string, unknown> = {
+    model: 'sound-effects-01',
+    prompt: options.prompt,
+  };
+  if (options.duration) body.duration = options.duration;
+
+  const headers: Record<string, string> = {
+    'Content-Type': 'application/json',
+    'Authorization': `Bearer ${apiKey}`,
+  };
+
+  const response = await fetch(`${baseUrl}/sound_generation`, {
+    method: 'POST',
+    headers,
+    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 { task_id: string };
+  console.log(`Task started: ${data.task_id}`);
+  console.log('Polling for completion...');
+
+  for (let i = 0; i < 60; i++) {
+    await new Promise(r => setTimeout(r, 3000));
+
+    const statusRes = await fetch(`${baseUrl}/query/sound_generation?task_id=${data.task_id}`, {
+      headers: { 'Authorization': `Bearer ${apiKey}` },
+    });
+    const status = await statusRes.json() as {
+      status: string;
+      extra_info?: { audio_url?: string };
+      audio_file?: string;
+      base_resp?: { status_msg: string };
+    };
+
+    if (status.status === 'Success') {
+      const audioUrl = status.extra_info?.audio_url || status.audio_file;
+      if (!audioUrl) throw new Error('No audio URL in response');
+
+      console.log('Sound effect generated. Downloading...');
+      const audioRes = await fetch(audioUrl);
+      if (!audioRes.ok) throw new Error(`Download failed: ${audioRes.status}`);
+      return Buffer.from(await audioRes.arrayBuffer());
+    }
+
+    if (status.status === 'Fail') {
+      throw new Error(`Sound effect generation failed: ${status.base_resp?.status_msg || 'Unknown error'}`);
+    }
+  }
+
+  throw new Error('Sound effect generation timed out');
+}
+
+async function main() {
+  const options = parseArgs();
+  if (!options) return;
+
+  try {
+    console.log('\n=== Sound Effect Generation ===\n');
+
+    const buffer = await generateMinimax(options);
+
+    const outputPath = resolve(options.output);
+    await mkdir(dirname(outputPath), { recursive: true });
+    await writeFile(outputPath, buffer);
+
+    console.log(`\nSound effect saved to: ${outputPath}`);
+    console.log(`Size: ${(buffer.length / 1024).toFixed(1)} KB`);
+    console.log('\nDone!\n');
+  } catch (error) {
+    console.error('\nError:', error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+}
+
+main();