@hasna/skills 0.0.2 → 0.0.4

package/skills/skill-calculate/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-calculate/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-chromedevtools/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-chromedevtools/README.md

@@ -1,27 +0,0 @@
-# skill-chromedevtools
-
-Browser automation and debugging with Chrome DevTools Protocol
-
-## Overview
-
-This Skill provides browser automation and debugging capabilities using the Chrome DevTools Protocol (CDP) for testing web applications, automating workflows, and debugging.
-
-## MCP Server
-
-Uses the Chrome DevTools MCP server for browser control.
-
-Connection: NPM package `chrome-devtools-mcp`
-
-## Usage
-
-This Skill is automatically invoked by Claude Code when working with browser automation tasks.
-
-Example requests:
-- "Navigate to example.com and take a screenshot"
-- "Fill out the login form and submit"
-- "Check console errors on this page"
-- "Monitor network requests"
-
-## Setup
-
-No API key required. Chrome must be installed on the system.

package/skills/skill-chromedevtools/SKILL.md

@@ -1,110 +0,0 @@
----
-name: skill-chromedevtools
-description: Browser automation and debugging with Chrome DevTools Protocol. Navigate pages, inspect elements, debug JavaScript, analyze network requests, and capture screenshots. Use for web testing, debugging, and browser automation tasks.
----
-
-# Chrome DevTools Skill
-
-## What this Skill does
-
-This Skill provides browser automation and debugging capabilities using the Chrome DevTools Protocol (CDP) for testing, debugging, and automating web interactions.
-
-## When to use this Skill
-
-Use this Skill when you need to:
-- Automate browser interactions and workflows
-- Debug web applications and inspect elements
-- Capture screenshots and page snapshots
-- Analyze network requests and responses
-- Execute JavaScript in browser context
-- Test web applications and user flows
-- Monitor console logs and errors
-- Evaluate page performance
-
-## MCP Server Connection
-
-The Chrome DevTools MCP server provides access to Chrome via the DevTools Protocol.
-
-```json
-{
-  "chrome-devtools": {
-    "command": "npx",
-    "args": ["-y", "chrome-devtools-mcp@latest", "--headless"],
-    "env": {
-      "CHROME_HEADLESS": "true",
-      "HEADLESS": "true"
-    }
-  }
-}
-```
-
-**Options**:
-- Add `--browserUrl http://localhost:9222` to connect to running Chrome instance
-- Remove `--headless` for visible browser
-- Use `--logFile /path/to/log` for debugging
-
-## Available Operations
-
-The Chrome DevTools MCP server provides tools for:
-
-- **Navigation**: Navigate to URLs, go back/forward, reload pages
-- **Element Interaction**: Click, type, fill forms, hover over elements
-- **Screenshots**: Capture full page or element screenshots
-- **Snapshots**: Take accessibility tree snapshots
-- **JavaScript Execution**: Evaluate scripts in page context
-- **Network Analysis**: Monitor requests, responses, and timing
-- **Console Monitoring**: Capture console logs and errors
-- **Dialog Handling**: Handle alerts, confirms, and prompts
-- **Performance**: Trace and analyze page performance
-
-## Browser Automation Features
-
-- **Headless Mode**: Run without visible browser window
-- **Multi-tab Support**: Manage multiple browser tabs
-- **Network Throttling**: Simulate slow connections
-- **Geolocation**: Emulate different locations
-- **Device Emulation**: Test mobile viewports
-- **File Upload**: Handle file input elements
-
-## Examples
-
-### Example 1: Navigate and screenshot
-"Go to example.com and take a screenshot"
-→ Claude navigates the browser and captures the page
-
-### Example 2: Test a form
-"Fill out the login form with test credentials and submit"
-→ Claude interacts with form elements and submits
-
-### Example 3: Debug JavaScript
-"Check the console for errors on this page"
-→ Claude captures and analyzes console output
-
-### Example 4: Analyze network
-"Monitor network requests when loading this page"
-→ Claude tracks all network activity
-
-### Example 5: Performance testing
-"Start a performance trace and reload the page"
-→ Claude captures performance metrics
-
-## Best practices
-
-- Use headless mode for faster automation
-- Take snapshots instead of screenshots for better accessibility
-- Wait for elements to be visible before interacting
-- Handle dialogs appropriately (accept/dismiss)
-- Monitor console errors for debugging
-- Use network filtering for specific request types
-- Capture screenshots for visual verification
-
-## Integration Notes
-
-The Chrome DevTools MCP server automatically handles:
-- Browser lifecycle management
-- Element location and interaction
-- Wait conditions and timeouts
-- Screenshot and snapshot capture
-- Network request tracking
-- Console message collection
-- Dialog detection and handling