@hasna/skills 0.1.27 → 0.1.30

package/skills/remove-background/src/index.ts

@@ -1,405 +0,0 @@
-#!/usr/bin/env bun
-
-/**
- * Remove Background Skill
- *
- * Removes backgrounds from images using local AI processing
- * Supports batch processing, custom backgrounds, and multiple output formats
- * No API key required - runs entirely locally
- */
-
-import { parseArgs } from "node:util";
-import { mkdir, writeFile, readFile, stat } from "node:fs/promises";
-import { join, basename, extname } from "node:path";
-import { existsSync } from "node:fs";
-
-// Types
-interface ProcessedImage {
-  input: string;
-  output: string;
-  size: string;
-  error?: string;
-}
-
-interface Metadata {
-  timestamp: string;
-  totalImages: number;
-  successful: number;
-  failed: number;
-  settings: {
-    bgColor: string;
-    format: string;
-  };
-  images: ProcessedImage[];
-}
-
-// Configuration
-const OUTPUT_BASE = process.env.SKILLS_OUTPUT_DIR || process.env.SKILLS_EXPORTS_DIR || ".skills";
-const PROJECT_ROOT = process.env.SKILLS_PROJECT_ROOT || process.cwd();
-
-// Supported formats
-const SUPPORTED_FORMATS = [".png", ".jpg", ".jpeg", ".webp"];
-
-/**
- * Parse command line arguments
- */
-function parseArguments() {
-  const { values, positionals } = parseArgs({
-    args: Bun.argv.slice(2),
-    options: {
-      "bg-color": { type: "string", default: "transparent" },
-      output: { type: "string", short: "o" },
-      format: { type: "string", default: "png" },
-      help: { type: "boolean", short: "h", default: false },
-    },
-    allowPositionals: true,
-  });
-
-  if (values.help) {
-    printHelp();
-    process.exit(0);
-  }
-
-  // Validate inputs
-  if (positionals.length === 0) {
-    console.error("Error: No image files specified");
-    console.error("Usage: skills run remove-background -- image.jpg [image2.png ...]");
-    console.error("Run with --help for more information");
-    process.exit(1);
-  }
-
-  // Validate format
-  if (!["png", "jpg", "webp"].includes(values.format as string)) {
-    console.error(`Error: Invalid format "${values.format}". Use: png, jpg, or webp`);
-    process.exit(1);
-  }
-
-  // Validate color format (if not transparent)
-  const bgColor = values["bg-color"] as string;
-  if (bgColor !== "transparent" && !/^#[0-9A-Fa-f]{6}$/.test(bgColor)) {
-    console.error(`Error: Invalid color format "${bgColor}". Use hex format like #FF5733 or "transparent"`);
-    process.exit(1);
-  }
-
-  return {
-    images: positionals,
-    bgColor,
-    outputDir: values.output as string | undefined,
-    format: values.format as string,
-  };
-}
-
-/**
- * Print help message
- */
-function printHelp() {
-  console.log(`
-Remove Background - AI-powered background removal (runs locally)
-
-USAGE:
-  skills run remove-background -- <images...> [options]
-
-OPTIONS:
-  --bg-color <color>    Background color (hex like #FF5733 or "transparent")
-  --output, -o <dir>    Custom output directory
-  --format <format>     Output format: png, jpg, webp (default: png)
-  -h, --help            Show this help message
-
-EXAMPLES:
-  # Basic usage
-  skills run remove-background -- photo.jpg
-
-  # White background
-  skills run remove-background -- product.jpg --bg-color "#FFFFFF"
-
-  # Batch process
-  skills run remove-background -- image1.jpg image2.png image3.webp
-
-  # Custom output directory
-  skills run remove-background -- image.jpg --output ./processed
-
-NOTE:
-  This skill runs locally using AI - no API key required.
-  First run may download the model (~30MB).
-`);
-}
-
-/**
- * Validate image file
- */
-async function validateImage(imagePath: string): Promise<boolean> {
-  try {
-    if (!existsSync(imagePath)) {
-      console.error(`File not found: ${imagePath}`);
-      return false;
-    }
-
-    const ext = extname(imagePath).toLowerCase();
-    if (!SUPPORTED_FORMATS.includes(ext)) {
-      console.error(`Unsupported format: ${imagePath} (use PNG, JPG, JPEG, or WebP)`);
-      return false;
-    }
-
-    const stats = await stat(imagePath);
-    const maxSize = 20 * 1024 * 1024; // 20 MB
-    if (stats.size > maxSize) {
-      console.error(`File too large: ${imagePath} (max 20 MB)`);
-      return false;
-    }
-
-    return true;
-  } catch (error) {
-    console.error(`Error validating ${imagePath}:`, error);
-    return false;
-  }
-}
-
-/**
- * Get mime type from file extension
- */
-function getMimeType(filePath: string): string {
-  const ext = extname(filePath).toLowerCase();
-  const mimeTypes: Record<string, string> = {
-    ".png": "image/png",
-    ".jpg": "image/jpeg",
-    ".jpeg": "image/jpeg",
-    ".webp": "image/webp",
-  };
-  return mimeTypes[ext] || "image/png";
-}
-
-/**
- * Remove background from image using local AI model
- */
-async function removeBackground(imagePath: string): Promise<Blob> {
-  // Dynamic import to avoid loading until needed
-  const { removeBackground: removeBg } = await import("@imgly/background-removal-node");
-
-  console.log("   Running local AI background removal...");
-
-  // Read image as blob with proper mime type
-  const imageBuffer = await readFile(imagePath);
-  const mimeType = getMimeType(imagePath);
-  const blob = new Blob([imageBuffer], { type: mimeType });
-
-  // Process with local AI model
-  const result = await removeBg(blob, {
-    progress: (key, current, total) => {
-      if (key === "compute:inference") {
-        const pct = Math.round((current / total) * 100);
-        process.stdout.write(`\r   Processing: ${pct}%`);
-      }
-    },
-  });
-
-  console.log("\r   Processing: 100%");
-  return result;
-}
-
-/**
- * Apply background color to transparent image
- */
-async function applyBackgroundColor(
-  imageBuffer: Buffer,
-  bgColor: string
-): Promise<Buffer> {
-  // If transparent, return as-is
-  if (bgColor === "transparent") {
-    return imageBuffer;
-  }
-
-  // Use sharp to composite with background color
-  const sharp = (await import("sharp")).default;
-
-  // Parse hex color
-  const r = parseInt(bgColor.slice(1, 3), 16);
-  const g = parseInt(bgColor.slice(3, 5), 16);
-  const b = parseInt(bgColor.slice(5, 7), 16);
-
-  // Get image dimensions
-  const metadata = await sharp(imageBuffer).metadata();
-  const width = metadata.width || 1;
-  const height = metadata.height || 1;
-
-  // Create solid color background
-  const background = await sharp({
-    create: {
-      width,
-      height,
-      channels: 4,
-      background: { r, g, b, alpha: 1 },
-    },
-  })
-    .png()
-    .toBuffer();
-
-  // Composite foreground over background
-  const result = await sharp(background)
-    .composite([{ input: imageBuffer, blend: "over" }])
-    .png()
-    .toBuffer();
-
-  return result;
-}
-
-/**
- * Format file size
- */
-function formatSize(bytes: number): string {
-  if (bytes < 1024) return `${bytes} B`;
-  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
-  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
-}
-
-/**
- * Process single image
- */
-async function processImage(
-  imagePath: string,
-  outputDir: string,
-  options: {
-    bgColor: string;
-    format: string;
-  }
-): Promise<ProcessedImage> {
-  try {
-    console.log(`\nProcessing: ${basename(imagePath)}`);
-
-    const isValid = await validateImage(imagePath);
-    if (!isValid) {
-      return {
-        input: imagePath,
-        output: "",
-        size: "0",
-        error: "Validation failed",
-      };
-    }
-
-    // Remove background
-    const resultBlob = await removeBackground(imagePath);
-    let resultBuffer = Buffer.from(await resultBlob.arrayBuffer());
-
-    // Apply background color if specified
-    if (options.bgColor !== "transparent") {
-      console.log(`   Applying background color: ${options.bgColor}`);
-      resultBuffer = await applyBackgroundColor(resultBuffer, options.bgColor);
-    }
-
-    // Convert to desired format
-    const sharp = (await import("sharp")).default;
-    if (options.format === "jpg") {
-      resultBuffer = await sharp(resultBuffer).jpeg({ quality: 95 }).toBuffer();
-    } else if (options.format === "webp") {
-      resultBuffer = await sharp(resultBuffer).webp({ quality: 95 }).toBuffer();
-    }
-
-    // Generate output filename
-    const ext = extname(imagePath);
-    const name = basename(imagePath, ext);
-    const outputExt = options.format === "jpg" ? ".jpg" : `.${options.format}`;
-    const outputPath = join(outputDir, `${name}-nobg${outputExt}`);
-
-    // Save processed image
-    await writeFile(outputPath, resultBuffer);
-
-    const stats = await stat(outputPath);
-
-    console.log(`   Saved: ${basename(outputPath)}`);
-    console.log(`   Size: ${formatSize(stats.size)}`);
-
-    return {
-      input: imagePath,
-      output: outputPath,
-      size: formatSize(stats.size),
-    };
-  } catch (error) {
-    console.error(`   Failed: ${error instanceof Error ? error.message : String(error)}`);
-    return {
-      input: imagePath,
-      output: "",
-      size: "0",
-      error: error instanceof Error ? error.message : String(error),
-    };
-  }
-}
-
-/**
- * Main function
- */
-async function main() {
-  console.log("Remove Background Skill v2.1.0\n");
-  console.log("   Powered by local AI (no API key needed)\n");
-
-  // Parse arguments
-  const args = parseArguments();
-
-  // Setup output directory
-  const timestamp = new Date().toISOString().replace(/[:.]/g, "-").split("T")[0] + "_" +
-                   new Date().toTimeString().split(" ")[0].replace(/:/g, "");
-
-  const outputDir = args.outputDir
-    ? join(PROJECT_ROOT, args.outputDir)
-    : join(OUTPUT_BASE, "remove-background", timestamp);
-
-  await mkdir(outputDir, { recursive: true });
-
-  console.log(`Output directory: ${outputDir}`);
-  console.log(`Background: ${args.bgColor}`);
-  console.log(`Format: ${args.format}`);
-  console.log(`Processing ${args.images.length} image(s)...`);
-
-  // Process all images
-  const results: ProcessedImage[] = [];
-  for (const imagePath of args.images) {
-    // Handle both absolute and relative paths
-    const absolutePath = imagePath.startsWith("/") ? imagePath : join(PROJECT_ROOT, imagePath);
-    const result = await processImage(absolutePath, outputDir, {
-      bgColor: args.bgColor,
-      format: args.format,
-    });
-    results.push(result);
-  }
-
-  // Calculate statistics
-  const successful = results.filter((r) => !r.error).length;
-  const failed = results.filter((r) => r.error).length;
-
-  // Create metadata
-  const metadata: Metadata = {
-    timestamp: new Date().toISOString(),
-    totalImages: results.length,
-    successful,
-    failed,
-    settings: {
-      bgColor: args.bgColor,
-      format: args.format,
-    },
-    images: results,
-  };
-
-  // Save metadata
-  const metadataPath = join(outputDir, "metadata.json");
-  await writeFile(metadataPath, JSON.stringify(metadata, null, 2));
-
-  // Print summary
-  console.log("\n" + "=".repeat(50));
-  console.log("Summary");
-  console.log("=".repeat(50));
-  console.log(`Successful: ${successful}`);
-  console.log(`Failed: ${failed}`);
-  console.log(`Output: ${outputDir}`);
-  console.log("=".repeat(50));
-
-  if (failed > 0) {
-    console.error("\nSome images failed to process. Check errors above.");
-    process.exit(1);
-  }
-
-  console.log("\nAll images processed successfully!");
-}
-
-// Run main function
-main().catch((error) => {
-  console.error("\nFatal error:", error);
-  process.exit(1);
-});

package/skills/sound-effects/SKILL.md

@@ -1,34 +0,0 @@
----
-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
-sound-effects generate --prompt "thunder rolling in the distance" --output ./thunder.mp3
-sound-effects generate --prompt "footsteps on gravel" --duration 5 --output ./steps.mp3
-sound-effects generate --prompt "spaceship engine humming" --output ./engine.mp3
-```
-
-## Environment Variables
-
-- `MINIMAX_API_KEY` — API key for Minimax (required)

package/skills/sound-effects/package.json

@@ -1,21 +0,0 @@
-{
-  "name": "sound-effects",
-  "version": "1.0.0",
-  "description": "Generate sound effects using AI backends",
-  "type": "module",
-  "bin": {
-    "sound-effects": "src/index.ts"
-  },
-  "scripts": {
-    "start": "bun run src/index.ts",
-    "generate": "bun run src/index.ts generate"
-  },
-  "dependencies": {},
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.0.0"
-  },
-  "peerDependencies": {
-    "typescript": "^5.0.0"
-  }
-}

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

@@ -1,172 +0,0 @@
-#!/usr/bin/env bun
-
-import { writeFile, mkdir } from 'fs/promises';
-import { resolve, dirname } from 'path';
-import { handleInstallCommand } from '../../_common';
-
-const SKILL_META = {
-  name: 'sound-effects',
-  description: 'Generate sound effects using AI (Minimax)',
-  version: '1.0.0',
-  commands: `Use: 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:
-  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:
-  sound-effects generate --prompt "thunder rolling" --output ./thunder.mp3
-  sound-effects generate --prompt "footsteps on gravel" --duration 5 --output ./steps.mp3
-  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();

package/skills/sound-effects/tsconfig.json

@@ -1,8 +0,0 @@
-{
-  "extends": "../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "dist",
-    "rootDir": "src"
-  },
-  "include": ["src"]
-}