@hasna/skills 0.0.2 → 0.0.3

package/skills/skill-download/src/installer.ts

@@ -1,324 +0,0 @@
-#!/usr/bin/env bun
-
-/**
- * Skill Installer Module
- *
- * Universal installer for skills to integrate with AI code assistants
- * Usage: skill-[name] install [claude|codex|windsurf|cursor]
- */
-
-import { writeFileSync, mkdirSync, existsSync, readFileSync } from 'fs';
-import { resolve, join } from 'path';
-import { homedir } from 'os';
-
-export interface SkillConfig {
-  name: string;
-  description: string;
-  version: string;
-  commands: Array<{
-    name: string;
-    description: string;
-    usage: string;
-    examples: string[];
-  }>;
-  requiredEnvVars?: string[];
-  optionalEnvVars?: string[];
-}
-
-export type AssistantType = 'claude' | 'codex' | 'windsurf' | 'cursor';
-
-const ASSISTANT_PATHS: Record<AssistantType, string> = {
-  claude: '.claude/skills',
-  codex: '.codex/skills',
-  windsurf: '.windsurf/skills',
-  cursor: '.cursor/skills',
-};
-
-export class SkillInstaller {
-  private config: SkillConfig;
-  private skillPath: string;
-
-  constructor(config: SkillConfig, currentFilePath: string) {
-    this.config = config;
-    // Get the root directory of the skill (where package.json is)
-    this.skillPath = resolve(currentFilePath, '..');
-  }
-
-  /**
-   * Install the skill to specified AI assistant
-   */
-  async install(assistant: AssistantType): Promise<void> {
-    console.log(`📦 Installing ${this.config.name} for ${assistant}...`);
-    console.log('');
-
-    const assistantPath = ASSISTANT_PATHS[assistant];
-    if (!assistantPath) {
-      throw new Error(`Unknown assistant: ${assistant}`);
-    }
-
-    // Create skill directory
-    const skillDir = join(homedir(), assistantPath, this.config.name);
-    mkdirSync(skillDir, { recursive: true });
-    console.log(`✓ Created: ${skillDir}`);
-
-    // Generate and write SKILL.md
-    const skillMd = this.generateSkillMd();
-    writeFileSync(join(skillDir, 'SKILL.md'), skillMd);
-    console.log(`✓ Created: SKILL.md`);
-
-    // Generate and write README.md
-    const readme = this.generateReadme();
-    writeFileSync(join(skillDir, 'README.md'), readme);
-    console.log(`✓ Created: README.md`);
-
-    // Create log file
-    const logFile = join(skillDir, `${this.config.name}.log`);
-    if (!existsSync(logFile)) {
-      writeFileSync(logFile, `# ${this.config.name} execution log\n# Created: ${new Date().toISOString()}\n\n`);
-      console.log(`✓ Created: ${this.config.name}.log`);
-    }
-
-    // Update MCP config
-    this.updateMcpConfig(assistant, skillDir);
-
-    console.log('');
-    console.log(`✅ ${this.config.name} installed successfully!`);
-    console.log('');
-    console.log('Location:', skillDir);
-    console.log('');
-    console.log('Usage:');
-    this.config.commands.slice(0, 3).forEach(cmd => {
-      console.log(`  ${this.config.name} ${cmd.usage}`);
-    });
-  }
-
-  /**
-   * Generate SKILL.md documentation
-   */
-  private generateSkillMd(): string {
-    const envVarsSection = this.config.requiredEnvVars?.length || this.config.optionalEnvVars?.length ? `
-
-## Environment Variables
-
-${this.config.requiredEnvVars?.length ? `### Required
-${this.config.requiredEnvVars.map(v => `- \`${v}\``).join('\n')}
-` : ''}
-${this.config.optionalEnvVars?.length ? `### Optional
-${this.config.optionalEnvVars.map(v => `- \`${v}\``).join('\n')}
-` : ''}` : '';
-
-    return `# ${this.config.name}
-
-${this.config.description}
-
-## Version
-${this.config.version}
-
-## Commands
-
-${this.config.commands.map(cmd => `### ${cmd.name}
-
-${cmd.description}
-
-**Usage:**
-\`\`\`bash
-${this.config.name} ${cmd.usage}
-\`\`\`
-
-**Examples:**
-${cmd.examples.map(ex => `\`\`\`bash
-${ex}
-\`\`\``).join('\n')}
-`).join('\n')}
-${envVarsSection}
-
-## Installation
-
-This skill is installed at:
-\`~/.claude/skills/${this.config.name}/\`
-
-## Logs
-
-Execution logs are written to:
-\`~/.claude/skills/${this.config.name}/${this.config.name}.log\`
-
-## Support
-
-For issues, visit: https://github.com/hasnaxyz/${this.config.name}/issues
-`;
-  }
-
-  /**
-   * Generate README.md
-   */
-  private generateReadme(): string {
-    return `# ${this.config.name}
-
-${this.config.description}
-
-## Quick Start
-
-\`\`\`bash
-${this.config.commands[0] ? `${this.config.name} ${this.config.commands[0].usage}` : `${this.config.name} --help`}
-\`\`\`
-
-## Documentation
-
-See [SKILL.md](./SKILL.md) for complete documentation.
-
-## Version
-
-${this.config.version}
-`;
-  }
-
-  /**
-   * Update MCP config to register the skill
-   */
-  private updateMcpConfig(assistant: AssistantType, skillDir: string): void {
-    const configPaths: Record<AssistantType, string> = {
-      claude: join(homedir(), '.config/claude-code/claude_mcp_config.json'),
-      codex: join(homedir(), '.config/codex/mcp_config.json'),
-      windsurf: join(homedir(), '.config/windsurf/mcp_config.json'),
-      cursor: join(homedir(), '.config/cursor/mcp_config.json'),
-    };
-
-    const configPath = configPaths[assistant];
-
-    // Read existing config or create new
-    let config: any = { mcpServers: {} };
-    if (existsSync(configPath)) {
-      const content = readFileSync(configPath, 'utf8');
-      config = JSON.parse(content);
-    }
-
-    if (!config.mcpServers) {
-      config.mcpServers = {};
-    }
-
-    // Add or update this skill
-    config.mcpServers[this.config.name] = {
-      command: 'bun',
-      args: ['run', join(this.skillPath, 'src/index.ts')],
-      env: this.getEnvConfig(),
-    };
-
-    // Write config
-    mkdirSync(resolve(configPath, '..'), { recursive: true });
-    writeFileSync(configPath, JSON.stringify(config, null, 2));
-    console.log(`✓ Updated: ${assistant} MCP config`);
-  }
-
-  /**
-   * Get environment variables config
-   */
-  private getEnvConfig(): Record<string, string> {
-    const env: Record<string, string> = {
-      SKILL_API_KEY: process.env.SKILL_API_KEY || '',
-    };
-
-    // Add required env vars
-    this.config.requiredEnvVars?.forEach(key => {
-      env[key] = process.env[key] || '';
-    });
-
-    // Add optional env vars
-    this.config.optionalEnvVars?.forEach(key => {
-      env[key] = process.env[key] || '';
-    });
-
-    return env;
-  }
-
-  /**
-   * Uninstall the skill from specified AI assistant
-   */
-  async uninstall(assistant: AssistantType): Promise<void> {
-    console.log(`🗑️  Uninstalling ${this.config.name} from ${assistant}...`);
-    console.log('');
-
-    const assistantPath = ASSISTANT_PATHS[assistant];
-    const skillDir = join(homedir(), assistantPath, this.config.name);
-
-    if (existsSync(skillDir)) {
-      // Remove from MCP config first
-      this.removeFromMcpConfig(assistant);
-
-      // Note: We don't delete the directory to preserve logs and user data
-      console.log(`✓ Removed from ${assistant} MCP config`);
-      console.log('');
-      console.log(`⚠️  Directory preserved: ${skillDir}`);
-      console.log('   (contains logs and configuration)');
-      console.log('   Delete manually if needed.');
-    } else {
-      console.log(`⚠️  ${this.config.name} is not installed for ${assistant}`);
-    }
-  }
-
-  /**
-   * Remove skill from MCP config
-   */
-  private removeFromMcpConfig(assistant: AssistantType): void {
-    const configPaths: Record<AssistantType, string> = {
-      claude: join(homedir(), '.config/claude-code/claude_mcp_config.json'),
-      codex: join(homedir(), '.config/codex/mcp_config.json'),
-      windsurf: join(homedir(), '.config/windsurf/mcp_config.json'),
-      cursor: join(homedir(), '.config/cursor/mcp_config.json'),
-    };
-
-    const configPath = configPaths[assistant];
-
-    if (existsSync(configPath)) {
-      const content = readFileSync(configPath, 'utf8');
-      const config = JSON.parse(content);
-
-      if (config.mcpServers && config.mcpServers[this.config.name]) {
-        delete config.mcpServers[this.config.name];
-        writeFileSync(configPath, JSON.stringify(config, null, 2));
-      }
-    }
-  }
-}
-
-/**
- * Helper to run installer from skill CLI
- */
-export async function runInstaller(
-  config: SkillConfig,
-  currentFilePath: string,
-  args: string[]
-): Promise<void> {
-  const installer = new SkillInstaller(config, currentFilePath);
-
-  const command = args[0];
-  const assistant = args[1] as AssistantType;
-
-  if (command === 'install') {
-    if (!assistant || !['claude', 'codex', 'windsurf', 'cursor'].includes(assistant)) {
-      console.error('❌ Error: Please specify an assistant');
-      console.error('');
-      console.error('Usage:');
-      console.error(`  ${config.name} install [claude|codex|windsurf|cursor]`);
-      console.error('');
-      console.error('Examples:');
-      console.error(`  ${config.name} install claude`);
-      console.error(`  ${config.name} install codex`);
-      process.exit(1);
-    }
-
-    await installer.install(assistant);
-  } else if (command === 'uninstall') {
-    if (!assistant || !['claude', 'codex', 'windsurf', 'cursor'].includes(assistant)) {
-      console.error('❌ Error: Please specify an assistant');
-      console.error('');
-      console.error('Usage:');
-      console.error(`  ${config.name} uninstall [claude|codex|windsurf|cursor]`);
-      process.exit(1);
-    }
-
-    await installer.uninstall(assistant);
-  } else {
-    console.error(`❌ Unknown installer command: ${command}`);
-    process.exit(1);
-  }
-}

package/skills/skill-download/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-exa/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Hasna
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/skills/skill-exa/README.md

@@ -1,26 +0,0 @@
-# skill-exa
-
-Advanced web search and code search using Exa AI
-
-## Overview
-
-This Skill provides semantic web search capabilities powered by Exa AI, specializing in finding code examples, technical documentation, and high-quality technical content.
-
-## MCP Server
-
-Uses the Exa MCP server for AI-powered search.
-
-Connection: NPM package `exa-mcp-server`
-
-## Usage
-
-This Skill is automatically invoked by Claude Code when performing web or code searches.
-
-Example requests:
-- "Search for React useState examples"
-- "Find FastAPI authentication documentation"
-- "What are best practices for Redis caching?"
-
-## Setup
-
-Get your Exa API key from: https://exa.ai

package/skills/skill-exa/SKILL.md

@@ -1,92 +0,0 @@
----
-name: skill-exa
-description: Advanced web search and code search using Exa AI. Search the web with semantic understanding, find code examples, documentation, and technical content. Use for research, finding examples, or discovering technical information.
----
-
-# Exa AI Search Skill
-
-## What this Skill does
-
-This Skill provides advanced web search capabilities using Exa AI, which specializes in semantic search, code discovery, and technical content retrieval.
-
-## When to use this Skill
-
-Use this Skill when you need to:
-- Search the web with semantic understanding
-- Find code examples and snippets
-- Discover documentation and technical articles
-- Research libraries, frameworks, and APIs
-- Get contextual information from web content
-- Find high-quality technical resources
-
-## MCP Server Connection
-
-The Exa MCP server provides access to Exa AI's search capabilities.
-
-```json
-{
-  "exa": {
-    "command": "npx",
-    "args": ["-y", "exa-mcp-server"],
-    "env": {
-      "EXA_API_KEY": "your-api-key-here"
-    }
-  }
-}
-```
-
-**Setup**: Get your API key from [exa.ai](https://exa.ai)
-
-## Available Operations
-
-The Exa MCP server provides tools for:
-
-- **Web Search**: Semantic web search with high-quality results
-- **Code Search**: Find code examples and implementations
-- **Documentation Search**: Discover technical documentation
-- **Content Extraction**: Get detailed content from URLs
-- **Similar Content**: Find related articles and resources
-
-## Search Capabilities
-
-Exa excels at:
-- Understanding intent and context
-- Finding technical and programming content
-- Filtering for quality sources
-- Providing relevant code examples
-- Discovering documentation and guides
-
-## Examples
-
-### Example 1: Find code examples
-"Search for React hooks examples using useEffect for data fetching"
-→ Claude uses Exa to find relevant code examples
-
-### Example 2: Research a library
-"Find documentation and examples for FastAPI authentication"
-→ Claude searches for FastAPI auth resources
-
-### Example 3: Technical research
-"What are the best practices for PostgreSQL connection pooling?"
-→ Claude uses Exa to find technical articles and documentation
-
-### Example 4: Find similar content
-"Find articles similar to this URL about microservices patterns"
-→ Claude discovers related technical content
-
-## Best practices
-
-- Use specific, technical queries for better results
-- Include programming languages or frameworks when searching for code
-- Ask for examples, documentation, or guides explicitly
-- Leverage semantic search for concept-based queries
-- Use Exa for technical content over general web search
-
-## Integration Notes
-
-The Exa MCP server automatically handles:
-- API authentication
-- Query optimization
-- Result ranking and filtering
-- Content extraction from URLs
-- Rate limiting