@hasna/skills 0.1.21 → 0.1.23

package/skills/skill-music/CLAUDE.md

@@ -0,0 +1,9 @@
+# skill-music
+
+AI music generation skill using Minimax Music-01.
+
+## Development
+
+- Runtime: Bun
+- Use `bun run dev` to run locally
+- Use `bun run typecheck` to check types

package/skills/skill-music/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: music
+version: 0.1.0
+description: Generate music tracks using AI models (Minimax Music-01)
+category: Content Generation
+tags:
+  - music
+  - generation
+  - ai
+  - minimax
+---
+
+# Music
+
+Generate full music tracks from text descriptions using AI. Describe the genre, mood, tempo, and style — get a complete audio track. Supports lyrics, instrumental references, and fine-grained control over the output.
+
+## Features
+
+- **Text-to-Music**: Describe any style and get a full track
+- **Lyrics Support**: Provide lyrics for vocal tracks
+- **Genre & Mood Control**: Specify genre, mood, and tempo
+- **Duration Control**: Set desired track length
+
+## Usage
+
+```bash
+skill-music generate --prompt "upbeat jazz piano" --output ./jazz.mp3
+skill-music generate --prompt "rock anthem" --lyrics "We are the champions" --output ./rock.mp3
+skill-music generate --prompt "lo-fi beats" --mood calm --tempo 80 --output ./lofi.mp3
+```
+
+## Environment Variables
+
+- `MINIMAX_API_KEY` — API key for Minimax (required)
+- `MINIMAX_GROUP_ID` — Group ID for Minimax (optional)

package/skills/{skill-generate-excel → skill-music}/package.json

@@ -1,10 +1,10 @@
 {
-  "name": "@hasnaxyz/skill-generate-excel",
+  "name": "@hasnaxyz/skill-music",
   "version": "0.1.0",
-  "description": "Generate Excel skill",
+  "description": "Generate music tracks using AI models (Minimax Music-01)",
   "type": "module",
   "bin": {
-    "skill-generate-excel": "./src/index.ts"
+    "skill-music": "./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-generate-excel.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

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

@@ -0,0 +1,192 @@
+#!/usr/bin/env bun
+
+import { writeFile, mkdir } from 'fs/promises';
+import { resolve, dirname } from 'path';
+import { handleInstallCommand } from '../../_common';
+
+const SKILL_META = {
+  name: 'skill-music',
+  description: 'Generate music tracks using AI (Minimax Music-01)',
+  version: '1.0.0',
+  commands: `Use: skill-music --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;
+  lyrics?: string;
+  genre?: string;
+  mood?: string;
+  tempo?: number;
+  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 '--lyrics': options.lyrics = args[++i]; break;
+      case '--genre': options.genre = args[++i]; break;
+      case '--mood': options.mood = args[++i]; break;
+      case '--tempo': options.tempo = parseInt(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(`
+Music Generation Skill
+
+Generate music using AI models (Minimax Music-01)
+
+USAGE:
+  skill-music generate [OPTIONS]
+
+OPTIONS:
+  --provider, -p <provider>   Provider (minimax) [default: minimax]
+  --prompt <text>             Description of the music to generate [required]
+  --output, -o <path>         Output file path [required]
+  --lyrics <text>             Song lyrics
+  --genre <genre>             Music genre (pop, rock, jazz, classical, electronic, etc.)
+  --mood <mood>               Desired mood (happy, sad, energetic, calm, etc.)
+  --tempo <bpm>               Tempo in BPM
+  --duration <seconds>        Duration in seconds
+
+EXAMPLES:
+  skill-music generate --prompt "upbeat jazz piano" --output ./jazz.mp3
+  skill-music generate --prompt "rock anthem" --lyrics "We are the champions" --output ./rock.mp3
+  skill-music generate --prompt "lo-fi beats" --mood calm --tempo 80 --output ./lofi.mp3
+
+ENVIRONMENT VARIABLES:
+  MINIMAX_API_KEY             API key for Minimax
+  MINIMAX_GROUP_ID            Group ID for Minimax (optional)
+`);
+}
+
+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 groupId = process.env.MINIMAX_GROUP_ID;
+  const baseUrl = 'https://api.minimax.chat/v1';
+
+  console.log(`Generating music with Minimax Music-01...`);
+  console.log(`Prompt: ${options.prompt}`);
+
+  const body: Record<string, unknown> = {
+    model: 'music-01',
+    prompt: options.prompt,
+  };
+  if (options.lyrics) body.lyrics = options.lyrics;
+  if (options.genre) body.genre = options.genre;
+  if (options.mood) body.mood = options.mood;
+  if (options.tempo) body.tempo = options.tempo;
+  if (options.duration) body.duration = options.duration;
+
+  const headers: Record<string, string> = {
+    'Content-Type': 'application/json',
+    'Authorization': `Bearer ${apiKey}`,
+  };
+  if (groupId) headers['X-Group-Id'] = groupId;
+
+  const response = await fetch(`${baseUrl}/music_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 < 120; i++) {
+    await new Promise(r => setTimeout(r, 5000));
+
+    const statusUrl = `${baseUrl}/query/music_generation?task_id=${data.task_id}`;
+    const statusRes = await fetch(statusUrl, { 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('Music 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(`Music generation failed: ${status.base_resp?.status_msg || 'Unknown error'}`);
+    }
+
+    if (i % 6 === 0) console.log(`  Still processing... (${Math.round((i * 5) / 60)}m elapsed)`);
+  }
+
+  throw new Error('Music generation timed out');
+}
+
+async function main() {
+  const options = parseArgs();
+  if (!options) return;
+
+  try {
+    console.log('\n=== Music Generation ===\n');
+
+    const buffer = await generateMinimax(options);
+
+    const outputPath = resolve(options.output);
+    await mkdir(dirname(outputPath), { recursive: true });
+    await writeFile(outputPath, buffer);
+
+    console.log(`\nMusic 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();

package/skills/skill-notion-manager/package.json

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

package/skills/skill-npmpublish/package.json

@@ -15,10 +15,6 @@
   "publishConfig": {
     "access": "restricted"
   },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-npmpublish.git"
-  },
   "keywords": [
     "npm",
     "publish",
@@ -27,7 +23,6 @@
     "claude",
     "codex"
   ],
-  "license": "Apache-2.0",
   "scripts": {
     "start": "bun run src/index.ts",
     "typecheck": "tsc --noEmit"

package/skills/skill-onboarding-sequence-builder/package.json

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

package/skills/skill-onsite-ops-checklist/package.json

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

package/skills/skill-outreach-cadence-designer/package.json

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

package/skills/skill-packaging-concept-studio/package.json

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

package/skills/skill-packing-plan-pro/package.json

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

package/skills/skill-parent-teacher-brief/package.json

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

package/skills/skill-partner-kit-assembler/package.json

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

package/skills/skill-payroll-change-prepper/package.json

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

package/skills/{skill-generate-pdf → 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-generate-docx → skill-pdf-generate}/package.json

@@ -1,17 +1,19 @@
 {
-  "name": "@hasnaxyz/skill-generate-docx",
+  "name": "@hasnaxyz/skill-pdf-generate",
   "version": "0.1.0",
-  "description": "Generate DOCX documents",
+  "description": "Generate PDF documents with rich formatting and layouts",
   "type": "module",
   "bin": {
-    "skill-generate-docx": "./src/index.ts"
+    "skill-pdf-generate": "./src/index.ts"
   },
   "scripts": {
     "start": "bun run src/index.ts",
     "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"

package/skills/{skill-generate-pdf → skill-pdf-generate}/src/index.ts

@@ -3,6 +3,8 @@
 import { existsSync, mkdirSync, appendFileSync, writeFileSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 
+type PdfLibModule = typeof import("pdf-lib");
+
 // Skill configuration
 const SKILL_NAME = "generate-pdf";
 const SESSION_ID = `${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
@@ -30,6 +32,14 @@ function log(message: string, level: "info" | "error" | "warn" = "info") {
   }
 }
 
+async function loadPdfLib(): Promise<PdfLibModule> {
+  try {
+    return await import("pdf-lib");
+  } catch {
+    throw new Error("Missing dependency 'pdf-lib'. Run bun install in this skill directory.");
+  }
+}
+
 // =============================================================================
 // Security: HTML Escaping to prevent XSS
 // =============================================================================
@@ -685,6 +695,99 @@ function generateHtml(options: GenerateOptions): string {
 </html>`;
 }
 
+function htmlToPlainText(html: string): string {
+  return html
+    .replace(/<style[\s\S]*?<\/style>/gi, "")
+    .replace(/<script[\s\S]*?<\/script>/gi, "")
+    .replace(/<\/(h1|h2|h3|p|div|li|tr)>/gi, "\n")
+    .replace(/<br\s*\/?>/gi, "\n")
+    .replace(/<[^>]+>/g, "")
+    .replace(/&nbsp;/g, " ")
+    .replace(/&amp;/g, "&")
+    .replace(/&lt;/g, "<")
+    .replace(/&gt;/g, ">")
+    .replace(/&quot;/g, '"')
+    .replace(/&#x27;/g, "'")
+    .split("\n")
+    .map((line) => line.trim())
+    .filter(Boolean)
+    .join("\n");
+}
+
+function pageSizeToPoints(format: string, orientation: "portrait" | "landscape"): [number, number] {
+  const size = PAGE_FORMATS[format] ?? PAGE_FORMATS.A4;
+  const width = (size.width / 25.4) * 72;
+  const height = (size.height / 25.4) * 72;
+  return orientation === "landscape" ? [height, width] : [width, height];
+}
+
+function wrapText(text: string, maxCharacters: number): string[] {
+  const lines: string[] = [];
+  for (const paragraph of text.split("\n")) {
+    let current = "";
+    for (const word of paragraph.split(/\s+/).filter(Boolean)) {
+      const candidate = current ? `${current} ${word}` : word;
+      if (candidate.length > maxCharacters && current) {
+        lines.push(current);
+        current = word;
+      } else {
+        current = candidate;
+      }
+    }
+    if (current) lines.push(current);
+    lines.push("");
+  }
+  return lines;
+}
+
+async function writePdfDocument(html: string, options: GenerateOptions, outputPath: string): Promise<void> {
+  const { PDFDocument, StandardFonts, rgb } = await loadPdfLib();
+  const pdfDoc = await PDFDocument.create();
+  const font = await pdfDoc.embedFont(StandardFonts.Helvetica);
+  const boldFont = await pdfDoc.embedFont(StandardFonts.HelveticaBold);
+  const [width, height] = pageSizeToPoints(options.format, options.orientation);
+  const margin = 54;
+  const fontSize = 11;
+  const lineHeight = 16;
+  const maxCharacters = Math.max(40, Math.floor((width - margin * 2) / (fontSize * 0.52)));
+  const lines = wrapText(htmlToPlainText(html), maxCharacters);
+
+  let page = pdfDoc.addPage([width, height]);
+  let y = height - margin;
+
+  if (options.title) {
+    page.drawText(options.title, {
+      x: margin,
+      y,
+      size: 18,
+      font: boldFont,
+      color: rgb(0.12, 0.18, 0.26),
+    });
+    y -= lineHeight * 2;
+  }
+
+  for (const line of lines) {
+    if (y < margin) {
+      page = pdfDoc.addPage([width, height]);
+      y = height - margin;
+    }
+
+    if (line) {
+      page.drawText(line, {
+        x: margin,
+        y,
+        size: fontSize,
+        font,
+        color: rgb(0.1, 0.1, 0.1),
+      });
+    }
+    y -= lineHeight;
+  }
+
+  const bytes = await pdfDoc.save();
+  writeFileSync(outputPath, bytes);
+}
+
 // Main execution
 async function main() {
   try {
@@ -709,28 +812,26 @@ async function main() {
       ? `${options.filename}.pdf`
       : `document_${SESSION_ID}.pdf`;
 
-    // Since we can't use Puppeteer in Bun easily, we'll output the HTML
-    // and create a simple text-based PDF representation
-    // In production, this would use a proper PDF library
-
-    // For now, save HTML that can be converted to PDF
     const htmlFile = join(EXPORTS_DIR, filename.replace('.pdf', '.html'));
     writeFileSync(htmlFile, html);
     log(`Saved HTML to: ${htmlFile}`);
+    const pdfFile = join(EXPORTS_DIR, filename);
+    await writePdfDocument(html, options, pdfFile);
+    log(`Saved PDF to: ${pdfFile}`);
 
     // Output result
     const result = {
       success: true,
-      message: "HTML document generated successfully",
+      message: "PDF document generated successfully",
       data: {
+        pdfFile,
         htmlFile,
-        filename: filename.replace('.pdf', '.html'),
+        filename,
         format: options.format,
         orientation: options.orientation,
         contentLength: html.length,
         template: options.template || null,
       },
-      note: "PDF conversion requires Puppeteer/Playwright. HTML file exported instead.",
     };
 
     console.log(JSON.stringify(result, null, 2));

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

@@ -0,0 +1,56 @@
+---
+name: pdf-read
+version: 0.1.0
+description: Read and extract text from multiple PDF files with page-range selection and parallel processing
+category: Data & Analysis
+tags:
+  - pdf
+  - documents
+  - extraction
+  - analysis
+  - reader
+---
+
+# PDF Read
+
+Read and extract text from PDF files. Supports multiple PDFs at once, page-range selection, chunked reading for large files, and parallel processing. Outputs text, JSON, or structured markdown.
+
+## Features
+
+- **Multiple PDFs**: Process many PDFs in a single command
+- **Page Ranges**: Read specific pages (e.g., `1-5`, `3,7,10-15`)
+- **Chunked Reading**: Break large PDFs into manageable chunks
+- **Parallel Processing**: Process multiple files concurrently
+- **Metadata Extraction**: Get page count, author, title, dates
+- **Output Formats**: Plain text, JSON with page structure, or markdown
+
+## Usage
+
+```bash
+# Read entire PDF
+skill-pdf-read read document.pdf
+
+# Read specific pages
+skill-pdf-read read report.pdf --pages 1-5
+
+# Read multiple PDFs
+skill-pdf-read read file1.pdf file2.pdf file3.pdf
+
+# Read in chunks of 10 pages
+skill-pdf-read read large-book.pdf --chunk-size 10
+
+# Get metadata only
+skill-pdf-read info document.pdf
+
+# Output as JSON with page structure
+skill-pdf-read read document.pdf --format json --output result.json
+```
+
+## Environment Variables
+
+- None required (pure local processing)
+
+## Requirements
+
+- Bun runtime
+- pdf-parse (auto-installed)