@hasna/skills 0.0.2 → 0.0.3

package/skills/skill-companyguide/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-compose-gmail/tsconfig.json

@@ -1,14 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "moduleResolution": "bundler",
-    "esModuleInterop": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "outDir": "dist",
-    "declaration": true,
-    "types": ["bun-types"]
-  },
-  "include": ["src/**/*", "bin/**/*"]
-}

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

@@ -1,27 +0,0 @@
-# skill-context7
-
-Access up-to-date library documentation and code examples
-
-## Overview
-
-This Skill provides access to curated, current documentation for programming libraries and frameworks through Context7's documentation database.
-
-## MCP Server
-
-Uses the Context7 MCP server for documentation retrieval.
-
-Connection: NPM package `@upstash/context7-mcp`
-
-## Usage
-
-This Skill is automatically invoked by Claude Code when looking up library documentation.
-
-Example requests:
-- "How do I use React's useEffect?"
-- "Show me FastAPI authentication examples"
-- "What are Next.js 14 best practices?"
-- "Give me Pandas DataFrame examples"
-
-## Setup
-
-No API key required - Context7 is free and open.

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();
-  }
-}