@hasna/skills 0.0.3 → 0.0.4

package/skills/skill-codefix/src/skill-install.ts

@@ -1,205 +0,0 @@
-/**
- * Skill Installation Handler
- *
- * Add this code to your skill's index.ts to enable:
- *   skill-[name] install claude
- *   skill-[name] install codex
- *   skill-[name] uninstall claude
- */
-
-import { writeFileSync, mkdirSync, existsSync } from 'fs';
-import { join } from 'path';
-import { homedir } from 'os';
-
-interface SkillMeta {
-  name: string;
-  description: string;
-  version: string;
-  commands: string; // Help text or command list
-  requiredEnvVars?: string[];
-}
-
-export async function handleInstallCommand(meta: SkillMeta, args: string[]): Promise<boolean> {
-  const command = args[0];
-  const assistant = args[1];
-
-  if (command !== 'install' && command !== 'uninstall') {
-    return false; // Not an install command
-  }
-
-  if (!assistant || !['claude', 'codex', 'windsurf', 'cursor'].includes(assistant)) {
-    console.error('❌ Error: Please specify an assistant');
-    console.error('');
-    console.error('Usage:');
-    console.error(`  ${meta.name} install [claude|codex|windsurf|cursor]`);
-    console.error(`  ${meta.name} uninstall [claude|codex|windsurf|cursor]`);
-    console.error('');
-    console.error('Examples:');
-    console.error(`  ${meta.name} install claude`);
-    console.error(`  ${meta.name} install codex`);
-    process.exit(1);
-  }
-
-  if (command === 'install') {
-    await installSkill(meta, assistant);
-  } else {
-    await uninstallSkill(meta, assistant);
-  }
-
-  return true;
-}
-
-async function installSkill(meta: SkillMeta, assistant: string): Promise<void> {
-  console.log(`📦 Installing ${meta.name} for ${assistant}...`);
-  console.log('');
-
-  const assistantPaths: Record<string, string> = {
-    claude: '.claude/skills',
-    codex: '.codex/skills',
-    windsurf: '.windsurf/skills',
-    cursor: '.cursor/skills',
-  };
-
-  const skillDir = join(homedir(), assistantPaths[assistant], meta.name);
-  mkdirSync(skillDir, { recursive: true });
-  console.log(`✓ Created: ${skillDir}`);
-
-  // Generate SKILL.md
-  const skillMd = generateSkillMd(meta);
-  writeFileSync(join(skillDir, 'SKILL.md'), skillMd);
-  console.log(`✓ Created: SKILL.md`);
-
-  // Generate README.md
-  const readme = generateReadme(meta);
-  writeFileSync(join(skillDir, 'README.md'), readme);
-  console.log(`✓ Created: README.md`);
-
-  // Create log file
-  const logFile = join(skillDir, `${meta.name}.log`);
-  if (!existsSync(logFile)) {
-    writeFileSync(logFile, `# ${meta.name} execution log\n# Created: ${new Date().toISOString()}\n\n`);
-    console.log(`✓ Created: ${meta.name}.log`);
-  }
-
-  console.log('');
-  console.log(`✅ ${meta.name} installed successfully!`);
-  console.log('');
-  console.log('Location:', skillDir);
-  console.log('');
-  console.log('Files created:');
-  console.log('  - SKILL.md (documentation)');
-  console.log('  - README.md (quick reference)');
-  console.log(`  - ${meta.name}.log (execution logs)`);
-}
-
-async function uninstallSkill(meta: SkillMeta, assistant: string): Promise<void> {
-  console.log(`🗑️  Uninstalling ${meta.name} from ${assistant}...`);
-  console.log('');
-
-  const assistantPaths: Record<string, string> = {
-    claude: '.claude/skills',
-    codex: '.codex/skills',
-    windsurf: '.windsurf/skills',
-    cursor: '.cursor/skills',
-  };
-
-  const skillDir = join(homedir(), assistantPaths[assistant], meta.name);
-
-  if (existsSync(skillDir)) {
-    console.log(`⚠️  Directory preserved: ${skillDir}`);
-    console.log('   (contains logs and configuration)');
-    console.log('   Delete manually if needed:');
-    console.log(`   rm -rf ${skillDir}`);
-  } else {
-    console.log(`✓ ${meta.name} is not installed for ${assistant}`);
-  }
-}
-
-function generateSkillMd(meta: SkillMeta): string {
-  // Extract skill type from name (e.g., "skill-audio" -> "audio")
-  const skillType = meta.name.replace('skill-', '');
-
-  // Create gerund form for description trigger (e.g., "audio" -> "generating audio")
-  const gerundForms: Record<string, string> = {
-    audio: 'generating audio',
-    image: 'generating images',
-    video: 'generating videos',
-    browse: 'browsing websites',
-    codefix: 'fixing code',
-    convert: 'converting files',
-    deploy: 'deploying applications',
-    emoji: 'generating emojis',
-    extract: 'extracting data',
-    transcript: 'transcribing audio',
-    transform: 'transforming data',
-    write: 'writing content',
-  };
-
-  const gerund = gerundForms[skillType] || `using ${skillType}`;
-
-  // Enhanced description with usage triggers
-  const enhancedDesc = `${meta.description}. Use when ${gerund} or when the user mentions ${skillType}.`;
-
-  const envSection = meta.requiredEnvVars?.length ? `
-
-## Environment Variables
-
-${meta.requiredEnvVars.map(v => `- \`${v}\``).join('\n')}
-
-Add to your \`~/.zshrc\` or \`~/.bashrc\`:
-\`\`\`bash
-${meta.requiredEnvVars.map(v => `export ${v}=your_key_here`).join('\n')}
-\`\`\`
-` : '';
-
-  return `---
-name: ${meta.name}
-description: ${enhancedDesc}
----
-
-# ${meta.name.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ')}
-
-${meta.description}
-
-## Quick Start
-
-\`\`\`bash
-${meta.commands}
-\`\`\`
-
-## Version
-
-${meta.version}${envSection}
-
-## Installation
-
-Installed at: \`~/.claude/skills/${meta.name}/\`
-
-## Logs
-
-Execution logs: \`~/.claude/skills/${meta.name}/${meta.name}.log\`
-
-## Support
-
-For issues, visit: https://github.com/hasnaxyz/${meta.name}/issues
-`;
-}
-
-function generateReadme(meta: SkillMeta): string {
-  return `# ${meta.name}
-
-${meta.description}
-
-**Version:** ${meta.version}
-
-## Documentation
-
-See [SKILL.md](./SKILL.md) for complete documentation.
-
-## Quick Reference
-
-\`\`\`bash
-${meta.name} --help
-\`\`\`
-`;
-}

package/skills/skill-convert/install.sh

@@ -1,112 +0,0 @@
-#!/usr/bin/env bash
-
-# Install script for skills
-# Installs the skill either globally for Claude Code or locally in a project
-
-set -e
-
-SKILL_NAME="$(basename "$(pwd)")"
-SKILL_PATH="$(pwd)"
-
-echo "📦 Installing $SKILL_NAME..."
-echo ""
-
-# Check if Claude Code is installed
-if ! command -v claude &> /dev/null; then
-    echo "⚠️  Claude Code not found in PATH"
-    echo "   Please install Claude Code first: https://claude.com/claude-code"
-    exit 1
-fi
-
-# Check if we're in a git repository
-if git rev-parse --git-dir > /dev/null 2>&1; then
-    IN_REPO=true
-    REPO_ROOT="$(git rev-parse --show-toplevel)"
-    echo "📁 Detected git repository: $REPO_ROOT"
-else
-    IN_REPO=false
-    echo "📁 Not in a git repository"
-fi
-
-# Ask installation type
-echo ""
-echo "Where would you like to install this skill?"
-if [ "$IN_REPO" = true ]; then
-    echo "  1) Locally (this repository only)"
-    echo "  2) Globally (all Claude Code sessions)"
-    read -p "Choose [1/2]: " choice
-else
-    echo "  Installing globally (not in a git repository)"
-    choice=2
-fi
-
-# Install function
-install_skill() {
-    local config_dir=$1
-    local config_file="$config_dir/claude_mcp_config.json"
-
-    # Create config directory if it doesn't exist
-    mkdir -p "$config_dir"
-
-    # Create or update config file
-    if [ ! -f "$config_file" ]; then
-        echo "{" > "$config_file"
-        echo '  "mcpServers": {}' >> "$config_file"
-        echo "}" >> "$config_file"
-    fi
-
-    # Add skill to config using bun
-    bun -e "
-    const fs = require('fs');
-    const config = JSON.parse(fs.readFileSync('$config_file', 'utf8'));
-
-    if (!config.mcpServers) config.mcpServers = {};
-
-    config.mcpServers['$SKILL_NAME'] = {
-      command: 'bun',
-      args: ['run', '$SKILL_PATH/src/index.ts'],
-      env: {
-        SKILL_API_KEY: process.env.SKILL_API_KEY || '',
-        ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY || '',
-        OPENAI_API_KEY: process.env.OPENAI_API_KEY || '',
-        ELEVENLABS_API_KEY: process.env.ELEVENLABS_API_KEY || '',
-        GEMINI_API_KEY: process.env.GEMINI_API_KEY || '',
-        XAI_API_KEY: process.env.XAI_API_KEY || '',
-        GOOGLE_API_KEY: process.env.GOOGLE_API_KEY || '',
-        GOOGLE_PROJECT_ID: process.env.GOOGLE_PROJECT_ID || '',
-        BROWSER_USE_API_KEY: process.env.BROWSER_USE_API_KEY || '',
-        RUNWAY_API_KEY: process.env.RUNWAY_API_KEY || ''
-      }
-    };
-
-    fs.writeFileSync('$config_file', JSON.stringify(config, null, 2));
-    "
-
-    echo "✅ Installed $SKILL_NAME to $config_file"
-}
-
-# Install based on choice
-if [ "$choice" = "1" ]; then
-    # Local installation
-    install_skill "$REPO_ROOT/.claude"
-    echo ""
-    echo "🎉 $SKILL_NAME installed locally!"
-    echo "   Config: $REPO_ROOT/.claude/claude_mcp_config.json"
-elif [ "$choice" = "2" ]; then
-    # Global installation
-    install_skill "$HOME/.config/claude-code"
-    echo ""
-    echo "🎉 $SKILL_NAME installed globally!"
-    echo "   Config: $HOME/.config/claude-code/claude_mcp_config.json"
-else
-    echo "❌ Invalid choice"
-    exit 1
-fi
-
-echo ""
-echo "📝 Next steps:"
-echo "   1. Restart Claude Code"
-echo "   2. The skill will be available as: $SKILL_NAME"
-echo ""
-echo "   Usage: Claude Code will automatically detect and use this skill"
-echo "          based on your prompts and task context."

package/skills/skill-convert/src/auth.ts

@@ -1,49 +0,0 @@
-/**
- * Skill Authentication Check
- * Add this to the top of any skill's main function
- */
-
-export function checkSkillAuth(): void {
-  const SKILL_API_KEY = process.env.SKILL_API_KEY;
-  
-  // Check if SKILL_API_KEY is set
-  if (!SKILL_API_KEY) {
-    console.error('❌ Error: SKILL_API_KEY environment variable not set');
-    console.error('');
-    console.error('To use this skill, you must set your SKILL_API_KEY:');
-    console.error('');
-    console.error('  export SKILL_API_KEY=your-api-key-here');
-    console.error('');
-    console.error('Contact your administrator to get your API key.');
-    process.exit(1);
-  }
-
-  // Validate key format
-  if (!SKILL_API_KEY.startsWith('sk-skill-')) {
-    console.error('❌ Error: Invalid SKILL_API_KEY format');
-    console.error('Expected format: sk-skill-xxxxxxxxxxxx');
-    process.exit(1);
-  }
-
-  // Key is valid - skill can proceed
-}
-
-/**
- * Check if running remotely (via SSH or network)
- */
-export function isRemoteExecution(): boolean {
-  return !!(
-    process.env.SSH_CONNECTION ||
-    process.env.SSH_CLIENT ||
-    process.env.SSH_TTY
-  );
-}
-
-/**
- * Require auth only if remote execution
- */
-export function requireAuthIfRemote(): void {
-  if (isRemoteExecution()) {
-    checkSkillAuth();
-  }
-}

package/skills/skill-convert/src/http-client.ts

@@ -1,128 +0,0 @@
-/**
- * Skill HTTP Client
- *
- * Generic HTTP client for calling the remote skill API server
- * Usage: import and call executeSkill() from your skill CLI
- */
-
-const SKILL_API_URL = process.env.SKILL_API_URL || "https://skill.hasnaxyz.com";
-
-export interface SkillRequest {
-  skill: string;
-  command?: string;
-  provider?: string;
-  prompt?: string;
-  text?: string;
-  output?: string;
-  [key: string]: unknown;
-}
-
-export interface SkillResponse {
-  success: boolean;
-  output?: string;
-  error?: string;
-  details?: string;
-}
-
-/**
- * Execute a skill on the remote server
- */
-export async function executeSkill(request: SkillRequest): Promise<SkillResponse | Blob> {
-  const { skill, ...params } = request;
-
-  const url = `${SKILL_API_URL}/${skill}/`;
-
-  // Get API key from environment
-  const apiKey = process.env.SKILL_API_KEY;
-  if (!apiKey) {
-    return {
-      success: false,
-      error: "Missing SKILL_API_KEY",
-      details: "Set SKILL_API_KEY environment variable"
-    };
-  }
-
-  try {
-    const response = await fetch(url, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "User-Agent": `skill-${skill}-cli/1.0`,
-        "X-API-Key": apiKey
-      },
-      body: JSON.stringify(params)
-    });
-
-    if (!response.ok) {
-      const error = await response.json();
-      return {
-        success: false,
-        error: error.error || `HTTP ${response.status}`,
-        details: error.details || error.message
-      };
-    }
-
-    // Check if response is a file (binary)
-    const contentType = response.headers.get("Content-Type") || "";
-    if (contentType.includes("image/") ||
-        contentType.includes("audio/") ||
-        contentType.includes("video/") ||
-        contentType.includes("application/")) {
-      return await response.blob();
-    }
-
-    // Otherwise JSON
-    return await response.json();
-
-  } catch (error) {
-    return {
-      success: false,
-      error: "Network error",
-      details: error instanceof Error ? error.message : String(error)
-    };
-  }
-}
-
-/**
- * Save a blob to a file
- */
-export async function saveBlob(blob: Blob, outputPath: string): Promise<void> {
-  const buffer = await blob.arrayBuffer();
-  await Bun.write(outputPath, buffer);
-}
-
-/**
- * Helper to execute a skill and save file if needed
- */
-export async function executeAndSave(request: SkillRequest): Promise<boolean> {
-  console.log(`🔗 Connecting to ${SKILL_API_URL}...`);
-
-  const result = await executeSkill(request);
-
-  if (result instanceof Blob) {
-    // File response
-    if (!request.output) {
-      console.error("❌ Error: No output path specified");
-      return false;
-    }
-
-    await saveBlob(result, request.output);
-    console.log(`✅ Saved to: ${request.output}`);
-    return true;
-  }
-
-  // JSON response
-  if (!result.success) {
-    console.error(`❌ Error: ${result.error}`);
-    if (result.details) {
-      console.error(`   ${result.details}`);
-    }
-    return false;
-  }
-
-  if (result.output) {
-    console.log(result.output);
-  }
-
-  return true;
-}

package/skills/skill-convert/src/index-http.ts

@@ -1,111 +0,0 @@
-#!/usr/bin/env bun
-
-/**
- * Skill Convert (HTTP Client)
- * Calls the remote skill API server 
- */
-
-import { executeAndSave, executeSkill } from './http-client';
-import { handleInstallCommand } from './skill-install';
-
-// Skill metadata for install command
-const SKILL_META = {
-  name: 'skill-convert',
-  description: 'Convert skill - calls remote API',
-  version: '1.0.0',
-  commands: `skill-convert <command> [options]`,
-  requiredEnvVars: ['SKILL_API_KEY'],
-};
-
-// Handle install/uninstall commands
-if (await handleInstallCommand(SKILL_META, process.argv.slice(2))) {
-  process.exit(0);
-}
-
-// Parse command line arguments
-function parseArgs(): Record<string, string | boolean> {
-  const args = process.argv.slice(2);
-  const parsed: Record<string, string | boolean> = {};
-
-  for (let i = 0; i < args.length; i++) {
-    if (args[i].startsWith('--')) {
-      const key = args[i].slice(2);
-      const value = args[i + 1];
-      if (value && !value.startsWith('--')) {
-        parsed[key] = value;
-        i++;
-      } else {
-        parsed[key] = true;
-      }
-    } else if (!parsed.command) {
-      parsed.command = args[i];
-    }
-  }
-
-  return parsed;
-}
-
-// Main logic
-async function main() {
-  const args = parseArgs();
-  const command = (args.command as string) || 'help';
-
-  if (command === 'help' || args.help) {
-    console.log(`Skill Convert CLI
-
-USAGE:
-  skill-convert <command> [options]
-
-COMMANDS:
-  Call with any command and it will be forwarded to the remote API server
-
-EXAMPLES:
-  skill-convert generate --provider <provider> [options]`);
-    return;
-  }
-
-  // Extract all parameters
-  const { command: cmd, ...params } = args;
-
-  // Check if output file is expected (for file-generating skills)
-  const fileSkills = ['audio', 'image', 'video', 'emoji'];
-  const isFileSkill = fileSkills.includes('convert');
-
-  if (isFileSkill && params.output) {
-    // Skill that generates files
-    const success = await executeAndSave({
-      skill: 'convert',
-      command: cmd,
-      ...params,
-    });
-    process.exit(success ? 0 : 1);
-  } else {
-    // Skill that returns JSON/text
-    const result = await executeSkill({
-      skill: 'convert',
-      command: cmd,
-      ...params,
-    });
-
-    if (result instanceof Blob) {
-      console.error('❌ Unexpected binary response');
-      process.exit(1);
-    }
-
-    if (result.success && result.output) {
-      console.log(result.output);
-    } else {
-      console.error(`❌ Error: ${result.error}`);
-      if (result.details) {
-        console.error(`   ${result.details}`);
-      }
-      process.exit(1);
-    }
-  }
-}
-
-// Run main
-main().catch((error) => {
-  console.error('❌ Fatal error:', error.message);
-  process.exit(1);
-});