@hasna/skills 0.1.20 → 0.1.22

package/skills/skill-mindfulness-prompt-cache/package.json

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

package/skills/skill-monitor/package.json

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

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-music/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@hasnaxyz/skill-music",
+  "version": "0.1.0",
+  "description": "Generate music tracks using AI models (Minimax Music-01)",
+  "type": "module",
+  "bin": {
+    "skill-music": "./src/index.ts"
+  },
+  "scripts": {
+    "dev": "bun run src/index.ts",
+    "build": "bun build src/index.ts --outdir dist --target node",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.7.0"
+  },
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "src",
+    "tsconfig.json"
+  ]
+}

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

@@ -1,10 +1,10 @@
 {
-  "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",

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)

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

@@ -0,0 +1,27 @@
+{
+  "name": "@hasnaxyz/skill-pdf-read",
+  "version": "0.1.0",
+  "description": "Read and extract text from PDF files with page-range selection and parallel processing",
+  "type": "module",
+  "bin": {
+    "skill-pdf-read": "./src/index.ts"
+  },
+  "scripts": {
+    "dev": "bun run src/index.ts",
+    "build": "bun build src/index.ts --outdir dist --target node",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.7.0"
+  },
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "src",
+    "tsconfig.json"
+  ]
+}