@hasna/skills 0.1.27 → 0.1.29

package/skills/webcrawling/package.json

@@ -4,7 +4,8 @@
   "description": "Web crawling service using Firecrawl API",
   "type": "module",
   "bin": {
-    "webcrawling": "./bin/cli.ts"
+    "webcrawling": "src/index.ts",
+    "webcrawl": "src/index.ts"
   },
   "scripts": {
     "dev": "bun run bin/cli.ts",

package/skills/write/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: Article Writer
+name: write
 description: Generate high-quality articles using parallel AI agents. Supports research, writing, and optional cover image generation. Write single articles or batch process multiple topics with configurable parallelism.
 ---
 
@@ -7,6 +7,8 @@ description: Generate high-quality articles using parallel AI agents. Supports r
 
 This skill spawns parallel AI agents to research and write articles on any topic. Each article goes through a multi-phase pipeline:
 
+This CLI is API-backed. Set `SKILL_API_KEY` when routing through the hosted skills/connectors runtime; provider-specific keys are managed by that runtime.
+
 1. **Research Agent** - Gathers information and key points about the topic
 2. **Writer Agent** - Creates a well-structured article based on the research
 3. **Image Agent** (optional) - Generates a cover image for the article
@@ -45,12 +47,10 @@ bun run src/index.ts batch \
 
 ## Configuration
 
-Set up API keys as environment variables:
+Set the hosted runtime API key:
+
 ```bash
-export ANTHROPIC_API_KEY=your_anthropic_key    # Required
-export OPENAI_API_KEY=your_openai_key          # For image generation
-export GOOGLE_API_KEY=your_google_key          # Alternative image provider
-export XAI_API_KEY=your_xai_key                # Alternative image provider
+export SKILL_API_KEY=your_skill_api_key
 ```
 
 ## Output Format

package/dist/server/serve.d.ts

@@ -1,11 +0,0 @@
-/**
- * Bun HTTP server for the Skills Dashboard.
- * Serves the Vite-built React dashboard and provides API routes.
- */
-export declare function createFetchHandler(options?: {
-    dashboardDir?: string;
-    dashboardExists?: boolean;
-}): (req: Request) => Promise<Response>;
-export declare function startServer(port?: number, options?: {
-    open?: boolean;
-}): Promise<void>;

package/skills/apidocs/.claude/settings.json

@@ -1,5 +0,0 @@
-{
-  "env": {
-    "CLAUDE_CODE_TASK_LIST_ID": "service-apidocs-dev"
-  }
-}

package/skills/audio/.env.example

@@ -1,14 +0,0 @@
-# Audio Generation API Keys
-# Copy this file to .env and fill in your API keys
-
-# ElevenLabs API Key
-# Get your key from: https://elevenlabs.io/
-ELEVENLABS_API_KEY=your_elevenlabs_api_key_here
-
-# OpenAI API Key
-# Get your key from: https://platform.openai.com/api-keys
-OPENAI_API_KEY=your_openai_api_key_here
-
-# Google Cloud Text-to-Speech API Key
-# Get your key from: https://console.cloud.google.com/apis/credentials
-GOOGLE_API_KEY=your_google_api_key_here

package/skills/audio/QUICKSTART.md

@@ -1,158 +0,0 @@
-# Quick Start Guide
-
-Get started with audio generation in under 5 minutes!
-
-## 1. Set Up API Keys
-
-Copy the example environment file:
-```bash
-cp .env.example .env
-```
-
-Edit `.env` and add at least one API key:
-```bash
-# Choose one or more providers:
-OPENAI_API_KEY=sk-...              # Easiest to get started
-ELEVENLABS_API_KEY=...             # Best voice quality
-GOOGLE_API_KEY=...                 # Most language options
-```
-
-## 2. Test the Installation
-
-List available voices (no API key needed for OpenAI):
-```bash
-bun run src/index.ts voices --provider openai
-```
-
-## 3. Generate Your First Audio
-
-### Option A: OpenAI TTS (Recommended for beginners)
-```bash
-bun run src/index.ts generate \
-  --provider openai \
-  --text "Hello, this is my first audio generation!" \
-  --voice nova \
-  --output ./test.mp3
-```
-
-### Option B: ElevenLabs (Best quality)
-```bash
-bun run src/index.ts generate \
-  --provider elevenlabs \
-  --text "Hello, this is my first audio generation!" \
-  --voice rachel \
-  --output ./test.mp3
-```
-
-### Option C: Google TTS (Most languages)
-```bash
-bun run src/index.ts generate \
-  --provider google \
-  --text "Hello, this is my first audio generation!" \
-  --language en-US \
-  --output ./test.mp3
-```
-
-## 4. Play Your Audio
-
-On macOS:
-```bash
-afplay test.mp3
-```
-
-On Linux:
-```bash
-mpg123 test.mp3
-# or
-ffplay test.mp3
-```
-
-On Windows:
-```bash
-start test.mp3
-```
-
-## Next Steps
-
-- Explore different voices: `bun run src/index.ts voices --provider <name>`
-- Try different speeds: Add `--speed 1.5` for faster speech
-- Use different models: Add `--model tts-1-hd` for higher quality (OpenAI)
-- See all options: `bun run src/index.ts help`
-
-## Common Use Cases
-
-### Podcast Intro
-```bash
-bun run src/index.ts generate \
-  --provider elevenlabs \
-  --text "Welcome to the Tech Talk podcast, where we discuss the latest in technology and innovation" \
-  --voice adam \
-  --output ./podcast_intro.mp3
-```
-
-### Multilingual Content (Google)
-```bash
-bun run src/index.ts generate \
-  --provider google \
-  --text "Bonjour, comment allez-vous?" \
-  --language fr-FR \
-  --output ./french_greeting.mp3
-```
-
-### Audiobook Narration
-```bash
-bun run src/index.ts generate \
-  --provider openai \
-  --text "Chapter 1: The Beginning. It was a dark and stormy night..." \
-  --voice fable \
-  --model tts-1-hd \
-  --speed 0.9 \
-  --output ./chapter1.mp3
-```
-
-## Troubleshooting
-
-**Error: API key not found**
-- Make sure you've created a `.env` file
-- Check that your API key is correctly formatted
-- Verify the environment variable name matches the provider
-
-**Error: Voice not found**
-- List available voices first: `bun run src/index.ts voices --provider <name>`
-- Use the exact voice ID from the list
-
-**Poor audio quality**
-- Use `--model tts-1-hd` with OpenAI for higher quality
-- Try `eleven_multilingual_v2` model with ElevenLabs
-- Adjust `--speed` for more natural speech
-
-## Getting API Keys
-
-### OpenAI (Easiest, $0.015/1K chars)
-1. Visit https://platform.openai.com/api-keys
-2. Sign up or log in
-3. Click "Create new secret key"
-4. Copy and paste into `.env`
-
-### ElevenLabs (Best quality, free tier available)
-1. Visit https://elevenlabs.io/
-2. Sign up for a free account (10K chars/month)
-3. Go to Profile > API Keys
-4. Copy and paste into `.env`
-
-### Google Cloud (Most languages, complex setup)
-1. Visit https://console.cloud.google.com/
-2. Create a project
-3. Enable Text-to-Speech API
-4. Create credentials (API key)
-5. Copy and paste into `.env`
-
-## Tips for Best Results
-
-1. **Keep sentences natural**: Punctuation affects pacing and intonation
-2. **Use appropriate voices**: Match voice to content (professional, casual, storytelling)
-3. **Adjust speed**: 0.9-1.0 for audiobooks, 1.0-1.2 for casual content
-4. **Test different providers**: Each has unique strengths
-5. **Mind your costs**: Monitor usage, especially with paid tiers
-
-Enjoy generating audio!

package/skills/audio/README.md

@@ -1,256 +0,0 @@
-# Audio Generation Skill
-
-A comprehensive Claude Code skill for generating high-quality audio using AI-powered text-to-speech APIs.
-
-## Features
-
-- Multiple TTS providers: ElevenLabs, OpenAI TTS, and Google Text-to-Speech
-- Simple, elegant CLI interface
-- Voice selection and listing
-- Multiple languages support
-- Customizable speech speed
-- Clean TypeScript implementation with full type safety
-- Native fetch API (no external HTTP libraries needed)
-
-## Supported Providers
-
-### ElevenLabs
-- Natural voice synthesis with voice cloning capabilities
-- Models: `eleven_multilingual_v2`, `eleven_flash_v2_5`, `eleven_v3`
-- Multiple languages and voice options
-- Professional-quality audio output
-
-### OpenAI TTS
-- High-quality text-to-speech
-- Models: `tts-1` (fast), `tts-1-hd` (high quality)
-- Voices: alloy, echo, fable, onyx, nova, shimmer
-- Speed control (0.25x to 4.0x)
-
-### Google Text-to-Speech
-- Cloud-based TTS service
-- Wide range of voices and languages
-- Natural-sounding speech synthesis
-- Configurable pitch and speaking rate
-
-## Installation
-
-1. Install Bun (if not already installed):
-```bash
-curl -fsSL https://bun.sh/install | bash
-```
-
-2. Clone and navigate to the skill directory:
-```bash
-git clone https://github.com/hasnaxyz/audio.git
-cd audio
-```
-
-3. Install dependencies:
-```bash
-bun install
-```
-
-4. Set up environment variables:
-```bash
-cp .env.example .env
-# Edit .env and add your API keys
-```
-
-## Configuration
-
-Create a `.env` file with your API keys:
-
-```bash
-ELEVENLABS_API_KEY=your_elevenlabs_api_key_here
-OPENAI_API_KEY=your_openai_api_key_here
-GOOGLE_API_KEY=your_google_api_key_here
-```
-
-### Getting API Keys
-
-- **ElevenLabs**: https://elevenlabs.io/
-- **OpenAI**: https://platform.openai.com/api-keys
-- **Google Cloud**: https://console.cloud.google.com/apis/credentials
-
-## Usage
-
-### Generate Audio
-
-#### ElevenLabs
-```bash
-bun run src/index.ts generate \
-  --provider elevenlabs \
-  --text "Hello world, this is a test of ElevenLabs text to speech" \
-  --voice rachel \
-  --model eleven_multilingual_v2 \
-  --output ./output.mp3
-```
-
-#### OpenAI TTS
-```bash
-bun run src/index.ts generate \
-  --provider openai \
-  --text "Hello world, this is a test of OpenAI text to speech" \
-  --voice nova \
-  --model tts-1-hd \
-  --speed 1.0 \
-  --output ./output.mp3
-```
-
-#### Google Text-to-Speech
-```bash
-bun run src/index.ts generate \
-  --provider google \
-  --text "Hello world, this is a test of Google text to speech" \
-  --language en-US \
-  --speed 1.0 \
-  --output ./output.mp3
-```
-
-### List Available Voices
-
-```bash
-# ElevenLabs voices
-bun run src/index.ts voices --provider elevenlabs
-
-# OpenAI voices
-bun run src/index.ts voices --provider openai
-
-# Google voices
-bun run src/index.ts voices --provider google
-```
-
-### Show Help
-
-```bash
-bun run src/index.ts help
-```
-
-## CLI Options
-
-### Generate Command
-
-| Option | Description | Required | Default |
-|--------|-------------|----------|---------|
-| `--provider` | Provider to use (elevenlabs, openai, google) | Yes | - |
-| `--text` | Text to convert to speech | Yes | - |
-| `--output` | Output file path (e.g., ./output.mp3) | Yes | - |
-| `--voice` | Voice to use (provider-specific) | No | Provider default |
-| `--model` | Model to use (provider-specific) | No | Provider default |
-| `--language` | Language code (Google TTS, e.g., en-US) | No | en-US |
-| `--speed` | Speaking speed (0.25-4.0) | No | 1.0 |
-
-### Voices Command
-
-| Option | Description | Required |
-|--------|-------------|----------|
-| `--provider` | Provider to list voices from | Yes |
-
-## Examples
-
-### Quick Test with Different Providers
-
-```bash
-# ElevenLabs - Natural voice
-bun run src/index.ts generate \
-  --provider elevenlabs \
-  --text "The quick brown fox jumps over the lazy dog" \
-  --voice rachel \
-  --output ./elevenlabs_test.mp3
-
-# OpenAI - High quality
-bun run src/index.ts generate \
-  --provider openai \
-  --text "The quick brown fox jumps over the lazy dog" \
-  --voice nova \
-  --model tts-1-hd \
-  --output ./openai_test.mp3
-
-# Google - Multilingual
-bun run src/index.ts generate \
-  --provider google \
-  --text "The quick brown fox jumps over the lazy dog" \
-  --language en-US \
-  --output ./google_test.mp3
-```
-
-### Generate with Custom Speed
-
-```bash
-# Slower speech
-bun run src/index.ts generate \
-  --provider openai \
-  --text "This is spoken slowly" \
-  --voice onyx \
-  --speed 0.75 \
-  --output ./slow.mp3
-
-# Faster speech
-bun run src/index.ts generate \
-  --provider openai \
-  --text "This is spoken quickly" \
-  --voice nova \
-  --speed 1.5 \
-  --output ./fast.mp3
-```
-
-## Project Structure
-
-```
-audio/
-├── SKILL.md              # Skill metadata and description
-├── README.md             # This file
-├── package.json          # Bun project configuration
-├── tsconfig.json         # TypeScript configuration
-├── .env.example          # Example environment variables
-├── src/
-│   ├── index.ts          # CLI entry point
-│   ├── types.ts          # TypeScript type definitions
-│   └── providers/
-│       ├── elevenlabs.ts # ElevenLabs provider
-│       ├── openai.ts     # OpenAI TTS provider
-│       └── google.ts     # Google TTS provider
-```
-
-## Development
-
-### Run in Development Mode
-
-```bash
-bun run dev
-```
-
-### Type Checking
-
-```bash
-bun run tsc --noEmit
-```
-
-## Error Handling
-
-The CLI provides clear error messages for common issues:
-
-- Missing API keys
-- Invalid providers
-- Voice not found
-- API errors
-- File write errors
-
-## Troubleshooting
-
-### "API key not found" error
-Make sure you've created a `.env` file with the appropriate API key for the provider you're using.
-
-### "Voice not found" error
-Use the `voices` command to list available voices for your chosen provider.
-
-### API errors
-Check that your API keys are valid and have sufficient credits/quota.
-
-## License
-
-MIT
-
-## Contributing
-
-Contributions are welcome! Please feel free to submit issues or pull requests.

package/skills/audio/src/index-local.ts

@@ -1,206 +0,0 @@
-#!/usr/bin/env bun
-
-/**
- * Audio Generation CLI
- * Unified interface for ElevenLabs, OpenAI TTS, and Google Text-to-Speech
- */
-import { handleInstallCommand } from '../../_common';
-
-
-// Handle install/uninstall commands
-const SKILL_META = {
-  name: 'audio',
-  description: 'Audio generation skill for Claude Code using ElevenLabs, OpenAI TTS, and Google Text-to-Speech',
-  version: '1.0.0',
-  commands: `Use: audio --help`,
-  requiredEnvVars: ['SKILL_API_KEY'],
-};
-
-if (await handleInstallCommand(SKILL_META, process.argv.slice(2))) {
-  process.exit(0);
-}
-
-import { MinimaxProvider } from './providers/minimax';
-import { ElevenLabsProvider } from './providers/elevenlabs';
-import { OpenAIProvider } from './providers/openai';
-import { GoogleProvider } from './providers/google';
-import type { AudioProvider, Provider } from './types';
-
-// Parse command line arguments
-function parseArgs(): {
-  command: string;
-  provider?: Provider;
-  text?: string;
-  voice?: string;
-  model?: string;
-  output?: string;
-  language?: string;
-  speed?: number;
-} {
-  const args = process.argv.slice(2);
-  const parsed: any = { command: args[0] || 'help' };
-
-  for (let i = 1; i < args.length; i += 2) {
-    const key = args[i].replace(/^--/, '');
-    const value = args[i + 1];
-    parsed[key] = value;
-  }
-
-  // Convert speed to number if present
-  if (parsed.speed) {
-    parsed.speed = parseFloat(parsed.speed);
-  }
-
-  return parsed;
-}
-
-// Get provider instance
-function getProvider(providerName: Provider): AudioProvider {
-  switch (providerName) {
-    case 'minimax':
-      return new MinimaxProvider();
-    case 'elevenlabs':
-      return new ElevenLabsProvider();
-    case 'openai':
-      return new OpenAIProvider();
-    case 'google':
-      return new GoogleProvider();
-    default:
-      throw new Error(
-        `Unknown provider: ${providerName}. Use: minimax, elevenlabs, openai, or google`
-      );
-  }
-}
-
-// Display help information
-function showHelp(): void {
-  console.log(`
-Audio Generation CLI - Generate high-quality audio using AI
-
-USAGE:
-  bun run src/index.ts <command> [options]
-
-COMMANDS:
-  generate    Generate audio from text
-  voices      List available voices for a provider
-  help        Show this help message
-
-GENERATE OPTIONS:
-  --provider <name>     Provider to use: elevenlabs, openai, google (required)
-  --text <text>         Text to convert to speech (required)
-  --voice <voice>       Voice to use (optional, provider-specific)
-  --model <model>       Model to use (optional, provider-specific)
-  --output <path>       Output file path (required, e.g., ./output.mp3)
-  --language <code>     Language code (optional, for Google TTS, e.g., en-US)
-  --speed <number>      Speaking speed (optional, 0.25-4.0, default: 1.0)
-
-VOICES OPTIONS:
-  --provider <name>     Provider to list voices from (required)
-
-EXAMPLES:
-  # Generate audio with ElevenLabs
-  bun run src/index.ts generate --provider elevenlabs --text "Hello world" --voice rachel --output ./output.mp3
-
-  # Generate audio with OpenAI TTS
-  bun run src/index.ts generate --provider openai --text "Hello world" --voice nova --output ./output.mp3
-
-  # Generate audio with Google TTS
-  bun run src/index.ts generate --provider google --text "Hello world" --language en-US --output ./output.mp3
-
-  # List available voices
-  bun run src/index.ts voices --provider elevenlabs
-  bun run src/index.ts voices --provider openai
-  bun run src/index.ts voices --provider google
-
-ENVIRONMENT VARIABLES:
-  ELEVENLABS_API_KEY    API key for ElevenLabs
-  OPENAI_API_KEY        API key for OpenAI
-  GOOGLE_API_KEY        API key for Google Cloud TTS
-`);
-}
-
-// Main CLI handler
-async function main(): Promise<void> {
-  const args = parseArgs();
-
-  try {
-    switch (args.command) {
-      case 'generate': {
-        if (!args.provider) {
-          console.error('Error: --provider is required');
-          console.error('Use: bun run src/index.ts help');
-          process.exit(1);
-        }
-        if (!args.text) {
-          console.error('Error: --text is required');
-          console.error('Use: bun run src/index.ts help');
-          process.exit(1);
-        }
-        if (!args.output) {
-          console.error('Error: --output is required');
-          console.error('Use: bun run src/index.ts help');
-          process.exit(1);
-        }
-
-        const provider = getProvider(args.provider as Provider);
-        console.log(`Generating audio with ${provider.name}...`);
-
-        await provider.generate({
-          text: args.text,
-          voice: args.voice,
-          model: args.model,
-          output: args.output,
-          language: args.language,
-          speed: args.speed,
-        });
-        break;
-      }
-
-      case 'voices': {
-        if (!args.provider) {
-          console.error('Error: --provider is required');
-          console.error('Use: bun run src/index.ts help');
-          process.exit(1);
-        }
-
-        const provider = getProvider(args.provider as Provider);
-        console.log(`Fetching voices from ${provider.name}...\n`);
-
-        const voices = await provider.listVoices();
-
-        if (voices.length === 0) {
-          console.log('No voices available');
-          break;
-        }
-
-        console.log(`Found ${voices.length} voices:\n`);
-        voices.forEach((voice) => {
-          console.log(`  ${voice.name} (${voice.id})`);
-          if (voice.description) {
-            console.log(`    ${voice.description}`);
-          }
-          if (voice.category) {
-            console.log(`    Category: ${voice.category}`);
-          }
-          console.log('');
-        });
-        break;
-      }
-
-      case 'help':
-        showHelp();
-        break;
-
-      default:
-        console.error(`Unknown command: ${args.command}`);
-        console.error('Use: bun run src/index.ts help');
-        process.exit(1);
-    }
-  } catch (error) {
-    console.error('Error:', error instanceof Error ? error.message : String(error));
-    process.exit(1);
-  }
-}
-
-// Run the CLI
-main();