@hasna/skills 0.1.23 → 0.1.24

package/skills/skill-managemcp/README.md

@@ -1,210 +0,0 @@
-# skill-managemcp
-
-Manage MCP servers - list, install, remove, and configure MCP server connections.
-
-A TypeScript service with CLI, API client, and database integration.
-
-## Features
-
-- CLI tool for managing MCP servers
-- HTTP server with REST API
-- PostgreSQL database with migrations
-- Configuration management
-- Installer for Claude/Codex tools
-
-## Installation
-
-```bash
-# Install dependencies
-bun install
-
-# Copy environment file
-cp .env.example .env
-
-# Edit .env with your configuration
-```
-
-## Configuration
-
-### Environment Variables
-
-Edit `.env` file with your configuration:
-
-```bash
-# Database
-DB_HOST=localhost
-DB_PORT=5432
-DB_NAME=managemcp_db
-DB_USER=postgres
-DB_PASSWORD=your-password-here
-
-# Server
-PORT=3000
-
-# API
-API_URL=https://api.example.com
-API_KEY=your-api-key-here
-```
-
-### CLI Configuration
-
-Configure the CLI tool:
-
-```bash
-# Set API URL
-bun cli config --set-api-url https://api.example.com
-
-# Set API key
-bun cli config --set-api-key your-api-key-here
-
-# Show current configuration
-bun cli config --show
-```
-
-## Database Setup
-
-```bash
-# Run migrations
-bun run db:migrate
-
-# Seed database
-bun run db:seed
-
-# Reset database (migrate + seed)
-bun run db:reset
-```
-
-## Development
-
-```bash
-# Start server with auto-reload
-bun run dev
-
-# Start server
-bun run start
-```
-
-## CLI Usage
-
-### Setup
-
-```bash
-# Interactive setup
-bun run cli setup
-```
-
-### Managing MCP Servers
-
-```bash
-# List all MCP servers
-bun run cli list
-
-# List with options
-bun run cli list --filter "category" --limit 20
-
-# Get MCP server by ID
-bun run cli get <server-id>
-
-# Search MCP servers
-bun run cli search "query" --limit 10
-
-# Add MCP server
-bun run cli add --name "Server Name" --description "Description"
-
-# Add MCP server with metadata
-bun run cli add --name "Server" --metadata '{"key": "value"}'
-```
-
-### Installation to Claude/Codex
-
-```bash
-# Install to both
-bun run cli install <server-id>
-
-# Install to specific target
-bun run cli install <server-id> --target claude
-bun run cli install <server-id> --target codex
-
-# Install multiple servers
-bun run cli install <id1> <id2> <id3>
-
-# Force overwrite
-bun run cli install <server-id> --force
-
-# Clear installed servers
-bun run cli install --clear
-
-# List installed servers
-bun run cli install --list
-```
-
-## API Endpoints
-
-The server provides the following REST API endpoints:
-
-### Health Check
-
-```bash
-GET /health
-```
-
-Returns server health status.
-
-### Items
-
-```bash
-# List items
-GET /api/items
-
-# Create item
-POST /api/items
-Content-Type: application/json
-
-{
-  "name": "Server name",
-  "description": "Server description",
-  "metadata": {"key": "value"}
-}
-```
-
-## Project Structure
-
-```
-.
-├── bin/
-│   └── cli.ts              # CLI entry point
-├── src/
-│   ├── lib/
-│   │   ├── api-client.ts   # API client functions
-│   │   ├── config.ts       # Configuration management
-│   │   ├── installer.ts    # Claude/Codex installer
-│   │   └── service-dir.ts  # Service directory management
-│   ├── db/
-│   │   └── index.ts        # Database connection
-│   └── server/
-│       └── index.ts        # HTTP server
-├── scripts/
-│   ├── migrate.ts          # Database migrations
-│   └── seed.ts             # Database seeding
-├── .env.example            # Environment template
-├── package.json            # Package configuration
-├── tsconfig.json           # TypeScript config
-└── README.md               # Documentation
-```
-
-## Scripts
-
-- `bun run dev` - Start server with auto-reload
-- `bun run start` - Start server
-- `bun run cli` - Run CLI tool
-- `bun run db:migrate` - Run migrations
-- `bun run db:seed` - Seed database
-- `bun run db:reset` - Reset database (migrate + seed)
-
-## License
-
-Apache-2.0
-
-## Author
-
-Hasna

package/skills/skill-managemcp/package.json

@@ -1,24 +0,0 @@
-{
-  "name": "skill-managemcp",
-  "version": "0.1.0",
-  "type": "module",
-  "description": "Manage MCP servers - list, install, remove, and configure MCP server connections",
-  "bin": {
-    "managemcp": "./bin/cli.ts"
-  },
-  "scripts": {
-    "dev": "bun run --watch src/server/index.ts",
-    "start": "bun run src/server/index.ts",
-    "cli": "bun run bin/cli.ts",
-    "db:migrate": "bun run scripts/migrate.ts",
-    "db:seed": "bun run scripts/seed.ts",
-    "db:reset": "bun run scripts/migrate.ts && bun run scripts/seed.ts"
-  },
-  "dependencies": {
-    "postgres": "^3.4.5"
-  },
-  "devDependencies": {
-    "@types/bun": "^1.1.14",
-    "typescript": "^5.7.2"
-  }
-}

package/skills/skill-managemcp/src/lib/service-dir.ts

@@ -1,119 +0,0 @@
-import { existsSync, mkdirSync, writeFileSync, appendFileSync } from "fs";
-import { join } from "path";
-import { homedir } from "os";
-
-const SERVICE_NAME = "skill-managemcp";
-const SERVICE_DIR_NAME = `.${SERVICE_NAME}`;
-
-export function getServiceDir(): string {
-  return join(homedir(), SERVICE_DIR_NAME);
-}
-
-export function getLogFilePath(): string {
-  return join(getServiceDir(), `${SERVICE_NAME}.log`);
-}
-
-export function getReadmePath(): string {
-  return join(getServiceDir(), "README.md");
-}
-
-export function isServiceDirInstalled(): boolean {
-  return existsSync(getServiceDir());
-}
-
-export function ensureServiceDir(): void {
-  if (!isServiceDirInstalled()) {
-    initServiceDir();
-  }
-}
-
-export function initServiceDir(force = false): { success: boolean; path: string; message: string } {
-  const serviceDir = getServiceDir();
-
-  if (existsSync(serviceDir) && !force) {
-    return {
-      success: false,
-      path: serviceDir,
-      message: "Already installed. Use --force to reinstall.",
-    };
-  }
-
-  mkdirSync(serviceDir, { recursive: true });
-
-  const readmeContent = generateReadme();
-  writeFileSync(getReadmePath(), readmeContent);
-
-  const logHeader = `# ${SERVICE_NAME} log file
-# Created: ${new Date().toISOString()}
-# This file contains activity history and logs.
-# -------------------------------------------------------
-
-`;
-  writeFileSync(getLogFilePath(), logHeader);
-
-  return {
-    success: true,
-    path: serviceDir,
-    message: `Installed at ${serviceDir}`,
-  };
-}
-
-function generateReadme(): string {
-  return `# .${SERVICE_NAME}
-
-This directory contains local configuration and logs for \`${SERVICE_NAME}\`.
-
-## Files
-
-| Path | Description |
-|------|-------------|
-| \`${SERVICE_NAME}.log\` | Activity log |
-| \`README.md\` | This file |
-
-## What is ${SERVICE_NAME}?
-
-\`${SERVICE_NAME}\` is a tool for managing MCP server connections.
-
-## Log File
-
-The \`${SERVICE_NAME}.log\` file contains:
-- Activity logs
-- Error logs
-- API activity
-
-## More Information
-
-For full documentation, run:
-
-\`\`\`bash
-${SERVICE_NAME} --help
-\`\`\`
-`;
-}
-
-export type LogLevel = "debug" | "info" | "warn" | "error";
-
-export function logToFile(message: string, level: LogLevel = "info"): void {
-  ensureServiceDir();
-
-  const timestamp = new Date().toISOString();
-  const logLine = `[${timestamp}] [${level.toUpperCase()}] ${message}\n`;
-
-  try {
-    appendFileSync(getLogFilePath(), logLine);
-  } catch {
-    // Silently fail
-  }
-}
-
-export function logInfo(message: string): void {
-  logToFile(message, "info");
-}
-
-export function logError(message: string): void {
-  logToFile(message, "error");
-}
-
-export function logWarn(message: string): void {
-  logToFile(message, "warn");
-}

package/skills/skill-managemcp/src/server/index.ts

@@ -1,108 +0,0 @@
-import { sql, testConnection, closeConnection } from '../db';
-
-const PORT = parseInt(process.env.PORT || '3000');
-const PATH_PREFIX = '/managemcp';
-const API_KEY = process.env.API_KEY || '';
-
-// API Key validation
-function validateApiKey(req: Request): boolean {
-  if (!API_KEY) return true; // No key configured = open access
-
-  const authHeader = req.headers.get('Authorization');
-  if (!authHeader?.startsWith('Bearer ')) return false;
-
-  return authHeader.slice(7) === API_KEY;
-}
-
-const connected = await testConnection();
-if (!connected) {
-  console.error('Failed to connect to database');
-  process.exit(1);
-}
-
-console.log('Database connection successful');
-
-async function handleRequest(req: Request): Promise<Response> {
-  const url = new URL(req.url);
-  let { pathname } = url;
-  const { searchParams } = url;
-  const method = req.method;
-
-  // Strip path prefix if present (for ALB routing)
-  if (pathname.startsWith(PATH_PREFIX)) {
-    pathname = pathname.slice(PATH_PREFIX.length) || '/';
-  }
-
-  try {
-    // Health check (no auth required)
-    if (pathname === '/health' && method === 'GET') {
-      return Response.json({
-        status: 'ok',
-        service: 'skill-managemcp',
-        timestamp: new Date().toISOString(),
-      });
-    }
-
-    // All routes below require authentication
-    if (!validateApiKey(req)) {
-      return Response.json({ error: 'Unauthorized' }, { status: 401 });
-    }
-
-    // List items
-    if (pathname === '/api/items' && method === 'GET') {
-      const limit = Math.min(parseInt(searchParams.get('limit') || '10'), 100);
-      const offset = Math.max(parseInt(searchParams.get('offset') || '0'), 0);
-
-      const items = await sql`
-        SELECT * FROM items
-        ORDER BY created_at DESC
-        LIMIT ${limit}
-        OFFSET ${offset}
-      `;
-      return Response.json({ items });
-    }
-
-    // Create item
-    if (pathname === '/api/items' && method === 'POST') {
-      const body = await req.json();
-
-      if (!body.name) {
-        return Response.json({ error: 'Name is required' }, { status: 400 });
-      }
-
-      const [item] = await sql`
-        INSERT INTO items (name, description, metadata)
-        VALUES (${body.name}, ${body.description || null}, ${JSON.stringify(body.metadata || {})})
-        RETURNING *
-      `;
-      return Response.json(item, { status: 201 });
-    }
-
-    return Response.json({ error: 'Not found' }, { status: 404 });
-  } catch (error) {
-    console.error('Request error:', error);
-    return Response.json({ error: 'Internal server error' }, { status: 500 });
-  }
-}
-
-const server = Bun.serve({
-  port: PORT,
-  fetch: handleRequest,
-});
-
-console.log(`Server running at http://localhost:${PORT}`);
-
-// Graceful shutdown
-process.on('SIGINT', async () => {
-  console.log('\nShutting down gracefully...');
-  server.stop();
-  await closeConnection();
-  process.exit(0);
-});
-
-process.on('SIGTERM', async () => {
-  console.log('\nShutting down gracefully...');
-  server.stop();
-  await closeConnection();
-  process.exit(0);
-});

package/skills/skill-manageskill/CLAUDE.md

@@ -1,48 +0,0 @@
-# CLAUDE.md
-
-Claude-specific instructions for working with the manageskill codebase.
-
-## Overview
-
-`skill-manageskill` is a TypeScript service for managing Claude Code skills. It provides a CLI tool, REST API server, and PostgreSQL database for listing, installing, removing, and configuring skills.
-
-## Architecture
-
-- **CLI tool** (Commander.js) - Primary interface at `bin/cli.ts`
-- **API server** (Bun HTTP) - REST API at `src/server/index.ts`
-- **Database** (PostgreSQL) - Data persistence at `src/db/index.ts`
-- **Config** - CLI config stored in `~/.manageskill.json`, server config via `.env`
-
-## Key Directories
-
-- `bin/` - CLI entry point
-- `src/lib/` - Core logic (api-client, config, installer, service-dir)
-- `src/server/` - HTTP server
-- `src/db/` - Database connection
-- `scripts/` - Database migration and seeding
-
-## Guidelines
-
-### DO:
-- Use Bun-native APIs (Bun.serve, Bun file operations)
-- Add TypeScript types for all new functions
-- Use parameterized queries with the `sql` tagged template
-- Handle errors gracefully with try-catch
-- Keep CLI commands focused and single-purpose
-- Use environment variables for secrets, config files for preferences
-
-### DON'T:
-- Don't add heavyweight frameworks (Express, Fastify, etc.)
-- Don't use ORMs (use raw SQL via postgres library)
-- Don't store secrets in code or config files
-
-## Common Operations
-
-```bash
-bun run dev          # Start server with auto-reload
-bun run start        # Start server
-bun run cli          # Run CLI tool
-bun run db:migrate   # Run migrations
-bun run db:seed      # Seed database
-bun run db:reset     # Reset database (migrate + seed)
-```

package/skills/skill-manageskill/README.md

@@ -1,210 +0,0 @@
-# skill-manageskill
-
-Manage Claude Code skills - list, install, remove, and configure skills.
-
-A TypeScript service with CLI, API client, and database integration.
-
-## Features
-
-- CLI tool for managing skills
-- HTTP server with REST API
-- PostgreSQL database with migrations
-- Configuration management
-- Installer for Claude/Codex tools
-
-## Installation
-
-```bash
-# Install dependencies
-bun install
-
-# Copy environment file
-cp .env.example .env
-
-# Edit .env with your configuration
-```
-
-## Configuration
-
-### Environment Variables
-
-Edit `.env` file with your configuration:
-
-```bash
-# Database
-DB_HOST=localhost
-DB_PORT=5432
-DB_NAME=manageskill_db
-DB_USER=postgres
-DB_PASSWORD=your-password-here
-
-# Server
-PORT=3000
-
-# API
-API_URL=https://api.example.com
-API_KEY=your-api-key-here
-```
-
-### CLI Configuration
-
-Configure the CLI tool:
-
-```bash
-# Set API URL
-bun cli config --set-api-url https://api.example.com
-
-# Set API key
-bun cli config --set-api-key your-api-key-here
-
-# Show current configuration
-bun cli config --show
-```
-
-## Database Setup
-
-```bash
-# Run migrations
-bun run db:migrate
-
-# Seed database
-bun run db:seed
-
-# Reset database (migrate + seed)
-bun run db:reset
-```
-
-## Development
-
-```bash
-# Start server with auto-reload
-bun run dev
-
-# Start server
-bun run start
-```
-
-## CLI Usage
-
-### Setup
-
-```bash
-# Interactive setup
-bun run cli setup
-```
-
-### Managing Skills
-
-```bash
-# List all skills
-bun run cli list
-
-# List with options
-bun run cli list --filter "category" --limit 20
-
-# Get skill by ID
-bun run cli get <skill-id>
-
-# Search skills
-bun run cli search "query" --limit 10
-
-# Add skill
-bun run cli add --name "Skill Name" --description "Description"
-
-# Add skill with metadata
-bun run cli add --name "Skill" --metadata '{"key": "value"}'
-```
-
-### Installation to Claude/Codex
-
-```bash
-# Install to both
-bun run cli install <skill-id>
-
-# Install to specific target
-bun run cli install <skill-id> --target claude
-bun run cli install <skill-id> --target codex
-
-# Install multiple skills
-bun run cli install <id1> <id2> <id3>
-
-# Force overwrite
-bun run cli install <skill-id> --force
-
-# Clear installed skills
-bun run cli install --clear
-
-# List installed skills
-bun run cli install --list
-```
-
-## API Endpoints
-
-The server provides the following REST API endpoints:
-
-### Health Check
-
-```bash
-GET /health
-```
-
-Returns server health status.
-
-### Items
-
-```bash
-# List items
-GET /api/items
-
-# Create item
-POST /api/items
-Content-Type: application/json
-
-{
-  "name": "Skill name",
-  "description": "Skill description",
-  "metadata": {"key": "value"}
-}
-```
-
-## Project Structure
-
-```
-.
-├── bin/
-│   └── cli.ts              # CLI entry point
-├── src/
-│   ├── lib/
-│   │   ├── api-client.ts   # API client functions
-│   │   ├── config.ts       # Configuration management
-│   │   ├── installer.ts    # Claude/Codex installer
-│   │   └── service-dir.ts  # Service directory management
-│   ├── db/
-│   │   └── index.ts        # Database connection
-│   └── server/
-│       └── index.ts        # HTTP server
-├── scripts/
-│   ├── migrate.ts          # Database migrations
-│   └── seed.ts             # Database seeding
-├── .env.example            # Environment template
-├── package.json            # Package configuration
-├── tsconfig.json           # TypeScript config
-└── README.md               # Documentation
-```
-
-## Scripts
-
-- `bun run dev` - Start server with auto-reload
-- `bun run start` - Start server
-- `bun run cli` - Run CLI tool
-- `bun run db:migrate` - Run migrations
-- `bun run db:seed` - Seed database
-- `bun run db:reset` - Reset database (migrate + seed)
-
-## License
-
-Apache-2.0
-
-## Author
-
-Hasna