@hasna/skills 0.0.2 → 0.0.4

package/skills/skill-context7/SKILL.md

@@ -1,103 +0,0 @@
----
-name: skill-context7
-description: Access up-to-date library documentation and code examples. Get current API references, usage examples, and best practices for any programming library or framework. Use when working with external libraries or needing documentation.
----
-
-# Context7 Documentation Skill
-
-## What this Skill does
-
-This Skill provides access to up-to-date documentation and code examples for programming libraries and frameworks through Context7's curated documentation database.
-
-## When to use this Skill
-
-Use this Skill when you need to:
-- Look up current library documentation
-- Find code examples for specific APIs
-- Learn best practices for frameworks
-- Get usage examples for library features
-- Understand API signatures and parameters
-- Find integration guides and tutorials
-- Access documentation for multiple library versions
-
-## MCP Server Connection
-
-The Context7 MCP server provides access to curated library documentation.
-
-```json
-{
-  "context7": {
-    "command": "npx",
-    "args": ["-y", "@upstash/context7-mcp@latest"]
-  }
-}
-```
-
-**No API key required** - Context7 is free and open
-
-## Available Operations
-
-The Context7 MCP server provides tools for:
-
-- **Library Search**: Find libraries by name or functionality
-- **Documentation Retrieval**: Get API docs and guides
-- **Code Examples**: Access practical usage examples
-- **Version Support**: View docs for specific versions
-- **Best Practices**: Learn recommended patterns
-- **Integration Guides**: Step-by-step setup instructions
-
-## Supported Libraries
-
-Context7 covers popular libraries across:
-- **JavaScript/TypeScript**: React, Next.js, Express, Vue, etc.
-- **Python**: FastAPI, Django, Flask, Pandas, etc.
-- **Go**: Gin, Echo, GORM, etc.
-- **Rust**: Actix, Tokio, Diesel, etc.
-- **And many more**: Database drivers, cloud SDKs, utilities
-
-## Documentation Modes
-
-Context7 provides two search modes:
-- **Code Mode** (default): API references and code examples
-- **Info Mode**: Conceptual guides and narrative documentation
-
-## Examples
-
-### Example 1: API reference lookup
-"How do I use React's useEffect hook?"
-→ Claude retrieves current useEffect documentation and examples
-
-### Example 2: Library integration
-"Show me how to set up FastAPI with PostgreSQL"
-→ Claude fetches integration guide and code examples
-
-### Example 3: Best practices
-"What are the best practices for Next.js data fetching?"
-→ Claude finds recommended patterns and examples
-
-### Example 4: Version-specific docs
-"How do I use React Server Components in Next.js 14?"
-→ Claude retrieves version-specific documentation
-
-### Example 5: Code examples
-"Give me examples of using Pandas groupby with aggregation"
-→ Claude provides practical code examples
-
-## Best practices
-
-- Specify the library and feature you need help with
-- Mention version numbers if working with specific releases
-- Ask for code examples when learning new APIs
-- Use for discovering best practices and patterns
-- Leverage for integration and setup guides
-- Reference when working with unfamiliar libraries
-
-## Integration Notes
-
-The Context7 MCP server automatically handles:
-- Library name resolution
-- Version matching
-- Documentation retrieval
-- Code example extraction
-- Best practice identification
-- Multi-library comparisons

package/skills/skill-context7/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-context7/package.json

@@ -1,31 +0,0 @@
-{
-  "name": "skill-context7",
-  "version": "1.0.0",
-  "description": "Access up-to-date library documentation and code examples",
-  "type": "module",
-  "main": "src/index.ts",
-  "bin": {
-    "skill-context7": "src/index.ts"
-  },
-  "scripts": {
-    "start": "bun run src/index.ts",
-    "dev": "bun run --watch src/index.ts"
-  },
-  "keywords": [
-    "claude",
-    "ai",
-    "skill"
-  ],
-  "author": "",
-  "license": "MIT",
-  "devDependencies": {
-    "@types/bun": "latest"
-  },
-  "peerDependencies": {
-    "typescript": "^5.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/hasnaxyz/skill-context7.git"
-  }
-}

package/skills/skill-context7/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-context7/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);
-  }
-}