@hasna/skills 0.0.2 → 0.0.3

package/skills/skill-browseruse/SKILL.md

@@ -1,113 +0,0 @@
----
-name: skill-browseruse
-description: AI-powered browser automation for complex web tasks. Natural language browser control, intelligent navigation, form filling, data extraction, and multi-step workflows. Use for advanced web automation, testing, and data collection tasks.
----
-
-# Browser Use AI Automation Skill
-
-## What this Skill does
-
-This Skill provides AI-powered browser automation that understands natural language instructions for complex web interactions, navigation, and data extraction tasks.
-
-## When to use this Skill
-
-Use this Skill when you need to:
-- Automate complex multi-step web workflows
-- Extract data from websites intelligently
-- Fill forms with contextual understanding
-- Navigate websites using natural language
-- Perform web research and data collection
-- Test user journeys with AI understanding
-- Handle dynamic content and SPAs
-- Solve CAPTCHAs and verification flows
-
-## MCP Server Connection
-
-The Browser Use MCP server provides AI-powered browser automation.
-
-```json
-{
-  "browser-use": {
-    "command": "/opt/homebrew/bin/uvx",
-    "args": ["--from", "browser-use[cli]", "browser-use", "--mcp"]
-  }
-}
-```
-
-**Requirements**: Python 3.10+ with uvx installed
-
-## Available Operations
-
-The Browser Use MCP server provides AI-driven tools for:
-
-- **Natural Language Navigation**: Describe where to go and it navigates
-- **Intelligent Form Filling**: Understands form context and fills appropriately
-- **Data Extraction**: Extract structured data using natural descriptions
-- **Multi-step Workflows**: Complete complex task sequences
-- **Dynamic Element Handling**: Works with SPAs and AJAX content
-- **Screenshot Analysis**: Visual understanding of pages
-- **Error Recovery**: Handles unexpected page states
-- **CAPTCHA Solving**: Intelligent verification handling
-
-## AI-Powered Features
-
-Browser Use leverages AI for:
-- **Understanding Intent**: Interprets high-level task descriptions
-- **Element Detection**: Finds elements without specific selectors
-- **Context Awareness**: Makes decisions based on page state
-- **Adaptive Navigation**: Handles different page layouts
-- **Error Handling**: Recovers from failures intelligently
-- **Data Structuring**: Extracts information in requested format
-
-## Examples
-
-### Example 1: Research and extraction
-"Go to Hacker News and extract the top 10 stories with titles and URLs"
-→ Browser Use navigates, finds elements, and extracts data
-
-### Example 2: Complex workflow
-"Search Google for 'best React libraries 2024', open the first result, and summarize the content"
-→ Browser Use executes multi-step workflow with understanding
-
-### Example 3: Form submission
-"Fill out the contact form with company information and submit"
-→ Browser Use understands form context and fills appropriately
-
-### Example 4: Comparison shopping
-"Compare prices for iPhone 15 on Amazon and Best Buy"
-→ Browser Use navigates both sites and extracts pricing
-
-### Example 5: Account creation
-"Create a test account on the staging site with random credentials"
-→ Browser Use completes registration flow intelligently
-
-## Best practices
-
-- Provide clear, high-level task descriptions
-- Let the AI handle element selection
-- Use for complex workflows that require decision-making
-- Leverage for data extraction over simple automation
-- Allow error recovery and retry logic
-- Use for tasks that need visual understanding
-- Describe desired output format for extractions
-- Trust the AI to adapt to page changes
-
-## Integration Notes
-
-The Browser Use MCP server automatically handles:
-- AI model selection and prompting
-- Browser lifecycle management
-- Element location with visual understanding
-- Error detection and recovery
-- Multi-step task planning
-- Data extraction and formatting
-- Screenshot analysis
-- Session management
-
-## Advanced Capabilities
-
-- **Proxy Support**: Route through proxies for geo-specific tasks
-- **Multi-page Handling**: Manage multiple tabs intelligently
-- **Session Persistence**: Maintain login state across tasks
-- **Rate Limiting**: Respectful automation with delays
-- **Visual Verification**: Screenshot-based validation

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

@@ -1,31 +0,0 @@
-{
-  "name": "skill-browseruse",
-  "version": "1.0.0",
-  "description": "AI-powered browser automation for complex web tasks",
-  "type": "module",
-  "main": "src/index.ts",
-  "bin": {
-    "skill-browseruse": "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-browseruse.git"
-  }
-}

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