@hasna/skills 0.1.27 → 0.1.29

package/skills/audio/src/index.ts

@@ -1,95 +0,0 @@
-#!/usr/bin/env bun
-
-import { executeAndSave, executeSkill, handleInstallCommand } from "../../_common";
-
-const SKILL = "audio";
-
-const SKILL_META = {
-  name: "audio",
-  description: "Generate speech and audio using provider-cost AI backends",
-  version: "1.0.0",
-  commands: "audio generate --provider <provider> --text <text> --output <file>",
-  requiredEnvVars: ["SKILL_API_KEY"],
-};
-
-if (await handleInstallCommand(SKILL_META, process.argv.slice(2))) {
-  process.exit(0);
-}
-
-function parseArgs(): Record<string, string | boolean> {
-  const parsed: Record<string, string | boolean> = {};
-  const args = process.argv.slice(2);
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (arg.startsWith("--")) {
-      const key = arg.slice(2);
-      const next = args[i + 1];
-      if (next && !next.startsWith("--")) {
-        parsed[key] = next;
-        i++;
-      } else {
-        parsed[key] = true;
-      }
-    } else if (!parsed.command) {
-      parsed.command = arg;
-    }
-  }
-  return parsed;
-}
-
-function printHelp() {
-  console.log(`Skill Audio CLI
-
-USAGE:
-  audio generate --provider <provider> --text <text> [options]
-
-PROVIDERS:
-  openai    tts-1, tts-1-hd
-  minimax   speech-2.8-turbo, speech-2.8-hd
-  gemini    gemini-2.5-flash-preview-tts, gemini-2.5-pro-preview-tts
-
-OPTIONS:
-  --model <model>    Provider model override
-  --text <text>      Text to synthesize
-  --voice <voice>    Provider-specific voice
-  --format <format>  mp3, wav, or opus
-  --output <path>    Save generated audio
-
-EXAMPLES:
-  audio generate --provider openai --text "Welcome to Skills.md" --voice alloy --output ./voice.mp3
-  audio generate --provider minimax --text "Fast narration" --output ./voice.mp3`);
-}
-
-async function main() {
-  const args = parseArgs();
-  const command = (args.command as string) || "help";
-
-  if (command === "help" || args.help) {
-    printHelp();
-    return;
-  }
-
-  const { command: _command, ...params } = args;
-  if (params.output) {
-    const success = await executeAndSave({ skill: SKILL, command, ...params });
-    process.exit(success ? 0 : 1);
-  }
-
-  const result = await executeSkill({ skill: SKILL, command, ...params });
-  if (result instanceof Blob) {
-    console.error("Unexpected binary response. Pass --output to save audio output.");
-    process.exit(1);
-  }
-  if (result.success && result.output) {
-    console.log(result.output);
-    return;
-  }
-  console.error(`Error: ${result.error || "Audio generation failed"}`);
-  if (result.details) console.error(result.details);
-  process.exit(1);
-}
-
-main().catch((error) => {
-  console.error(`Fatal error: ${(error as Error).message}`);
-  process.exit(1);
-});

package/skills/audio/src/providers/elevenlabs.ts

@@ -1,115 +0,0 @@
-/**
- * ElevenLabs Text-to-Speech Provider
- * Supports text-to-speech, voice cloning, and multiple languages
- */
-
-import type {
-  AudioProvider,
-  GenerateOptions,
-  Voice,
-  ElevenLabsVoice,
-  ElevenLabsGenerateRequest,
-} from '../types';
-
-export class ElevenLabsProvider implements AudioProvider {
-  name = 'ElevenLabs';
-  private apiKey: string;
-  private baseUrl = 'https://api.elevenlabs.io/v1';
-
-  constructor() {
-    const apiKey = process.env.ELEVENLABS_API_KEY;
-    if (!apiKey) {
-      throw new Error('ELEVENLABS_API_KEY environment variable is required');
-    }
-    this.apiKey = apiKey;
-  }
-
-  async generate(options: GenerateOptions): Promise<void> {
-    const {
-      text,
-      voice = 'rachel',
-      model = 'eleven_multilingual_v2',
-      output,
-    } = options;
-
-    // Get voice ID from voice name
-    const voiceId = await this.getVoiceId(voice);
-
-    const requestBody: ElevenLabsGenerateRequest = {
-      text,
-      model_id: model,
-      voice_settings: {
-        stability: 0.5,
-        similarity_boost: 0.5,
-      },
-    };
-
-    const url = `${this.baseUrl}/text-to-speech/${voiceId}`;
-
-    const response = await fetch(url, {
-      method: 'POST',
-      headers: {
-        'Accept': 'audio/mpeg',
-        'Content-Type': 'application/json',
-        'xi-api-key': this.apiKey,
-      },
-      body: JSON.stringify(requestBody),
-    });
-
-    if (!response.ok) {
-      const errorText = await response.text();
-      throw new Error(`ElevenLabs API error: ${response.status} - ${errorText}`);
-    }
-
-    const audioBuffer = await response.arrayBuffer();
-    await Bun.write(output, audioBuffer);
-
-    console.log(`Audio generated successfully: ${output}`);
-  }
-
-  async listVoices(): Promise<Voice[]> {
-    const url = `${this.baseUrl}/voices`;
-
-    const response = await fetch(url, {
-      headers: {
-        'xi-api-key': this.apiKey,
-      },
-    });
-
-    if (!response.ok) {
-      const errorText = await response.text();
-      throw new Error(`ElevenLabs API error: ${response.status} - ${errorText}`);
-    }
-
-    const data = await response.json() as { voices: ElevenLabsVoice[] };
-
-    return data.voices.map((voice) => ({
-      id: voice.voice_id,
-      name: voice.name,
-      description: voice.description,
-      previewUrl: voice.preview_url,
-      category: voice.category,
-    }));
-  }
-
-  private async getVoiceId(voiceName: string): Promise<string> {
-    // If it's already a voice ID (long alphanumeric string), use it directly
-    if (voiceName.length > 20) {
-      return voiceName;
-    }
-
-    // Otherwise, look up the voice by name
-    const voices = await this.listVoices();
-    const voice = voices.find(
-      (v) => v.name.toLowerCase() === voiceName.toLowerCase()
-    );
-
-    if (!voice) {
-      throw new Error(
-        `Voice "${voiceName}" not found. Use "voices" command to list available voices.`
-      );
-    }
-
-    return voice.id;
-  }
-}

package/skills/audio/src/providers/google.ts

@@ -1,116 +0,0 @@
-/**
- * Google Cloud Text-to-Speech Provider
- * Supports multiple languages and voices
- */
-
-import type {
-  AudioProvider,
-  GenerateOptions,
-  Voice,
-  GoogleTTSRequest,
-  GoogleTTSVoice,
-} from '../types';
-
-export class GoogleProvider implements AudioProvider {
-  name = 'Google Text-to-Speech';
-  private apiKey: string;
-  private baseUrl = 'https://texttospeech.googleapis.com/v1';
-
-  constructor() {
-    const apiKey = process.env.GOOGLE_API_KEY;
-    if (!apiKey) {
-      throw new Error('GOOGLE_API_KEY environment variable is required');
-    }
-    this.apiKey = apiKey;
-  }
-
-  async generate(options: GenerateOptions): Promise<void> {
-    const {
-      text,
-      voice,
-      language = 'en-US',
-      output,
-      speed = 1.0,
-    } = options;
-
-    // Default voice settings
-    let voiceName = voice;
-    let ssmlGender: 'MALE' | 'FEMALE' | 'NEUTRAL' = 'NEUTRAL';
-
-    // If voice is specified, try to find it in available voices
-    if (voice) {
-      const voices = await this.listVoices();
-      const selectedVoice = voices.find(
-        (v) => v.name.toLowerCase().includes(voice.toLowerCase()) ||
-               v.id === voice
-      );
-
-      if (selectedVoice) {
-        voiceName = selectedVoice.id;
-      }
-    }
-
-    // If no voice specified or not found, use default for language
-    if (!voiceName) {
-      voiceName = `${language}-Standard-A`;
-    }
-
-    const requestBody: GoogleTTSRequest = {
-      input: {
-        text,
-      },
-      voice: {
-        languageCode: language,
-        name: voiceName,
-        ssmlGender,
-      },
-      audioConfig: {
-        audioEncoding: 'MP3',
-        speakingRate: Math.max(0.25, Math.min(4.0, speed)),
-      },
-    };
-
-    const url = `${this.baseUrl}/text:synthesize?key=${this.apiKey}`;
-
-    const response = await fetch(url, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-      },
-      body: JSON.stringify(requestBody),
-    });
-
-    if (!response.ok) {
-      const errorText = await response.text();
-      throw new Error(`Google TTS API error: ${response.status} - ${errorText}`);
-    }
-
-    const data = await response.json() as { audioContent: string };
-
-    // Decode base64 audio content
-    const audioBuffer = Buffer.from(data.audioContent, 'base64');
-    await Bun.write(output, audioBuffer);
-
-    console.log(`Audio generated successfully: ${output}`);
-  }
-
-  async listVoices(): Promise<Voice[]> {
-    const url = `${this.baseUrl}/voices?key=${this.apiKey}`;
-
-    const response = await fetch(url);
-
-    if (!response.ok) {
-      const errorText = await response.text();
-      throw new Error(`Google TTS API error: ${response.status} - ${errorText}`);
-    }
-
-    const data = await response.json() as { voices: GoogleTTSVoice[] };
-
-    return data.voices.map((voice) => ({
-      id: voice.name,
-      name: voice.name,
-      description: `${voice.languageCodes.join(', ')} - ${voice.ssmlGender}`,
-      category: voice.languageCodes[0],
-    }));
-  }
-}

package/skills/audio/src/providers/minimax.ts

@@ -1,83 +0,0 @@
-import type { AudioProvider, GenerateOptions, Voice } from '../types';
-import { writeFile } from 'fs/promises';
-
-export class MinimaxProvider implements AudioProvider {
-  name = 'Minimax Speech-02-HD';
-  private apiKey: string;
-  private baseUrl = 'https://api.minimax.chat/v1';
-
-  constructor() {
-    this.apiKey = process.env.MINIMAX_API_KEY || '';
-    if (!this.apiKey) {
-      throw new Error('MINIMAX_API_KEY environment variable is required');
-    }
-  }
-
-  async generate(options: GenerateOptions): Promise<void> {
-    console.log(`Generating audio with ${this.name}...`);
-
-    const body: Record<string, unknown> = {
-      model: options.model || 'speech-02-hd',
-      text: options.text,
-    };
-
-    if (options.voice || options.speed) {
-      const voiceSetting: Record<string, unknown> = {};
-      if (options.voice) voiceSetting.voice_id = options.voice;
-      if (options.speed) voiceSetting.speed = options.speed;
-      body.voice_setting = voiceSetting;
-    }
-
-    const format = options.output.endsWith('.wav') ? 'wav' :
-                   options.output.endsWith('.flac') ? 'flac' : 'mp3';
-    body.audio_setting = { format };
-
-    if (options.language) {
-      body.language_boost = options.language;
-    }
-
-    const response = await fetch(`${this.baseUrl}/t2a_v2`, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'Authorization': `Bearer ${this.apiKey}`,
-      },
-      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 {
-      data?: { audio?: string };
-      base_resp?: { status_code: number; status_msg: string };
-    };
-
-    if (data.base_resp && data.base_resp.status_code !== 0) {
-      throw new Error(`Minimax TTS error: ${data.base_resp.status_msg}`);
-    }
-
-    if (!data.data?.audio) {
-      throw new Error('No audio data in response');
-    }
-
-    const audioBuffer = Buffer.from(data.data.audio, 'hex');
-    await writeFile(options.output, audioBuffer);
-    console.log(`Audio saved to: ${options.output}`);
-  }
-
-  async listVoices(): Promise<Voice[]> {
-    return [
-      { id: 'male-qn-qingse', name: 'Qingse (Male)', description: 'Young male, clear voice' },
-      { id: 'female-shaonv', name: 'Shaonv (Female)', description: 'Young female voice' },
-      { id: 'female-yujie', name: 'Yujie (Female)', description: 'Mature female voice' },
-      { id: 'male-qn-jingying', name: 'Jingying (Male)', description: 'Male elite voice' },
-      { id: 'presenter_male', name: 'Presenter Male', description: 'Professional male presenter' },
-      { id: 'presenter_female', name: 'Presenter Female', description: 'Professional female presenter' },
-      { id: 'audiobook_male_1', name: 'Audiobook Male', description: 'Audiobook narrator male' },
-      { id: 'audiobook_female_1', name: 'Audiobook Female', description: 'Audiobook narrator female' },
-    ];
-  }
-}

package/skills/audio/src/providers/openai.ts

@@ -1,115 +0,0 @@
-/**
- * OpenAI Text-to-Speech Provider
- * Supports high-quality TTS with multiple voices
- */
-
-import type {
-  AudioProvider,
-  GenerateOptions,
-  Voice,
-  OpenAIGenerateRequest,
-} from '../types';
-
-export class OpenAIProvider implements AudioProvider {
-  name = 'OpenAI TTS';
-  private apiKey: string;
-  private baseUrl = 'https://api.openai.com/v1';
-
-  // Available voices in OpenAI TTS
-  private availableVoices: Voice[] = [
-    {
-      id: 'alloy',
-      name: 'Alloy',
-      description: 'Neutral and balanced voice',
-    },
-    {
-      id: 'echo',
-      name: 'Echo',
-      description: 'Warm and expressive voice',
-    },
-    {
-      id: 'fable',
-      name: 'Fable',
-      description: 'Storytelling voice with British accent',
-    },
-    {
-      id: 'onyx',
-      name: 'Onyx',
-      description: 'Deep and authoritative voice',
-    },
-    {
-      id: 'nova',
-      name: 'Nova',
-      description: 'Energetic and youthful voice',
-    },
-    {
-      id: 'shimmer',
-      name: 'Shimmer',
-      description: 'Soft and gentle voice',
-    },
-  ];
-
-  constructor() {
-    const apiKey = process.env.OPENAI_API_KEY;
-    if (!apiKey) {
-      throw new Error('OPENAI_API_KEY environment variable is required');
-    }
-    this.apiKey = apiKey;
-  }
-
-  async generate(options: GenerateOptions): Promise<void> {
-    const {
-      text,
-      voice = 'nova',
-      model = 'tts-1',
-      output,
-      speed = 1.0,
-    } = options;
-
-    // Validate voice
-    const validVoice = this.availableVoices.find(
-      (v) => v.id === voice.toLowerCase() || v.name.toLowerCase() === voice.toLowerCase()
-    );
-
-    if (!validVoice) {
-      throw new Error(
-        `Voice "${voice}" not found. Available voices: ${this.availableVoices
-          .map((v) => v.id)
-          .join(', ')}`
-      );
-    }
-
-    const requestBody: OpenAIGenerateRequest = {
-      model,
-      input: text,
-      voice: validVoice.id,
-      response_format: 'mp3',
-      speed: Math.max(0.25, Math.min(4.0, speed)), // Clamp between 0.25 and 4.0
-    };
-
-    const url = `${this.baseUrl}/audio/speech`;
-
-    const response = await fetch(url, {
-      method: 'POST',
-      headers: {
-        'Authorization': `Bearer ${this.apiKey}`,
-        'Content-Type': 'application/json',
-      },
-      body: JSON.stringify(requestBody),
-    });
-
-    if (!response.ok) {
-      const errorText = await response.text();
-      throw new Error(`OpenAI API error: ${response.status} - ${errorText}`);
-    }
-
-    const audioBuffer = await response.arrayBuffer();
-    await Bun.write(output, audioBuffer);
-
-    console.log(`Audio generated successfully: ${output}`);
-  }
-
-  async listVoices(): Promise<Voice[]> {
-    return this.availableVoices;
-  }
-}

package/skills/audio/src/types.ts

@@ -1,79 +0,0 @@
-/**
- * Shared types and interfaces for audio generation providers
- */
-
-export type Provider = 'minimax' | 'elevenlabs' | 'openai' | 'google';
-
-export interface GenerateOptions {
-  text: string;
-  voice?: string;
-  model?: string;
-  output: string;
-  language?: string;
-  speed?: number;
-}
-
-export interface Voice {
-  id: string;
-  name: string;
-  description?: string;
-  previewUrl?: string;
-  category?: string;
-}
-
-export interface AudioProvider {
-  name: string;
-  generate(options: GenerateOptions): Promise<void>;
-  listVoices(): Promise<Voice[]>;
-}
-
-export interface ElevenLabsVoice {
-  voice_id: string;
-  name: string;
-  category?: string;
-  description?: string;
-  preview_url?: string;
-  labels?: Record<string, string>;
-}
-
-export interface ElevenLabsGenerateRequest {
-  text: string;
-  model_id?: string;
-  voice_settings?: {
-    stability?: number;
-    similarity_boost?: number;
-    style?: number;
-    use_speaker_boost?: boolean;
-  };
-}
-
-export interface OpenAIGenerateRequest {
-  model: string;
-  input: string;
-  voice: string;
-  response_format?: 'mp3' | 'opus' | 'aac' | 'flac';
-  speed?: number;
-}
-
-export interface GoogleTTSRequest {
-  input: {
-    text: string;
-  };
-  voice: {
-    languageCode: string;
-    name?: string;
-    ssmlGender?: 'MALE' | 'FEMALE' | 'NEUTRAL';
-  };
-  audioConfig: {
-    audioEncoding: string;
-    speakingRate?: number;
-    pitch?: number;
-  };
-}
-
-export interface GoogleTTSVoice {
-  languageCodes: string[];
-  name: string;
-  ssmlGender: string;
-  naturalSampleRateHertz: number;
-}

package/skills/audiobook-chapter-proofer/CLAUDE.md

@@ -1,19 +0,0 @@
-# audiobook-chapter-proofer
-
-Audiobook Chapter Proofer skill.
-
-## Tech Stack
-
-- Runtime: Bun
-- Language: TypeScript
-- CLI: Commander.js
-
-## CLI
-
-```bash
-audiobook-chapter-proofer run
-```
-
-## Data Directory
-
-~/.skill/audiobook-chapter-proofer/

package/skills/audiobook-chapter-proofer/package.json

@@ -1,27 +0,0 @@
-{
-  "name": "audiobook-chapter-proofer",
-  "version": "0.1.0",
-  "description": "Audiobook Chapter Proofer skill",
-  "type": "module",
-  "bin": {
-    "audiobook-chapter-proofer": "./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"
-  ]
-}