@hasna/skills 0.0.2 → 0.0.4

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

@@ -1,27 +0,0 @@
-# skill-notion
-
-Manage Notion workspace, pages, databases, and content
-
-## Overview
-
-This Skill provides comprehensive Notion workspace management for creating pages, managing databases, searching content, and organizing documentation.
-
-## MCP Server
-
-Uses the Notion MCP server for workspace access.
-
-Connection: Remote HTTP at `https://mcp.notion.com/mcp`
-
-## Usage
-
-This Skill is automatically invoked by Claude Code when working with Notion tasks.
-
-Example requests:
-- "Create a Notion page for the API design"
-- "Add a task to the Sprint Planning database"
-- "Find all pages about authentication"
-- "Show me high-priority tasks"
-
-## Setup
-
-Authenticate via OAuth when first connecting to Notion MCP.

package/skills/skill-notion/SKILL.md

@@ -1,115 +0,0 @@
----
-name: skill-notion
-description: Manage Notion workspace, pages, databases, and content. Create, update, search pages, manage databases, add comments, and organize content. Use when working with Notion documents, wikis, or project management.
----
-
-# Notion Workspace Management Skill
-
-## What this Skill does
-
-This Skill provides comprehensive Notion workspace management capabilities, allowing you to create, update, search, and organize Notion content through the MCP server.
-
-## When to use this Skill
-
-Use this Skill when you need to:
-- Create and update Notion pages
-- Manage databases and their records
-- Search across your Notion workspace
-- Add comments and collaborate on pages
-- Organize content with tags and properties
-- Query database views and filters
-- Move and structure pages
-- Export and sync content
-
-## MCP Server Connection
-
-The Notion MCP server provides access to your Notion workspace via API.
-
-### Remote Connection (Recommended)
-```json
-{
-  "notion": {
-    "httpUrl": "https://mcp.notion.com/mcp"
-  }
-}
-```
-
-### NPM Package
-```json
-{
-  "notion": {
-    "command": "npx",
-    "args": ["-y", "mcp-remote", "https://mcp.notion.com/mcp"]
-  }
-}
-```
-
-**Setup**: Authenticate via OAuth when first connecting
-
-## Available Operations
-
-The Notion MCP server provides tools for:
-
-- **Page Management**: Create, read, update, delete pages
-- **Database Operations**: Query, filter, sort database records
-- **Search**: Full-text search across workspace
-- **Comments**: Add and manage page comments
-- **Properties**: Set page properties and metadata
-- **Blocks**: Manipulate page content blocks
-- **Users**: Get user information and mentions
-- **Teams**: Manage teamspaces
-
-## Content Types
-
-Notion supports rich content including:
-- Text with formatting (bold, italic, code)
-- Headings and lists
-- Code blocks
-- Tables and databases
-- Images and files
-- Embeds and bookmarks
-- Callouts and quotes
-
-## Examples
-
-### Example 1: Create a page
-"Create a Notion page about the new API design"
-→ Claude creates a structured page with content
-
-### Example 2: Update database
-"Add a new task to the Sprint Planning database"
-→ Claude creates a database entry with properties
-
-### Example 3: Search content
-"Find all pages mentioning 'authentication'"
-→ Claude searches and lists matching pages
-
-### Example 4: Query database
-"Show me all high-priority tasks assigned to me"
-→ Claude filters and displays database records
-
-### Example 5: Add documentation
-"Create meeting notes for today's standup"
-→ Claude creates a formatted notes page
-
-## Best practices
-
-- Use rich formatting for better readability
-- Leverage databases for structured content
-- Add properties for filtering and organization
-- Use search to find existing content before creating
-- Tag and categorize pages appropriately
-- Link related pages together
-- Use templates for consistent structure
-- Add comments for collaboration
-
-## Integration Notes
-
-The Notion MCP server automatically handles:
-- OAuth authentication and token refresh
-- Page and block hierarchy
-- Database schema and properties
-- Rich text formatting
-- File uploads and attachments
-- User mentions and permissions
-- Rate limiting and retries