@hasna/skills 0.0.3 → 0.1.1

package/skills/skill-managemcp/README.md

@@ -1,12 +1,12 @@
-# service-{{name}}
+# skill-managemcp
 
-{{description}}
+Manage MCP servers - list, install, remove, and configure MCP server connections.
 
-A TypeScript service template with CLI, API client, and database integration.
+A TypeScript service with CLI, API client, and database integration.
 
 ## Features
 
-- CLI tool for managing items
+- CLI tool for managing MCP servers
 - HTTP server with REST API
 - PostgreSQL database with migrations
 - Configuration management
@@ -34,9 +34,9 @@ Edit `.env` file with your configuration:
 # Database
 DB_HOST=localhost
 DB_PORT=5432
-DB_NAME={{name}}_db
+DB_NAME=managemcp_db
 DB_USER=postgres
-DB_PASSWORD=postgres
+DB_PASSWORD=your-password-here
 
 # Server
 PORT=3000
@@ -93,48 +93,48 @@ bun run start
 bun run cli setup
 ```
 
-### Managing Items
+### Managing MCP Servers
 
 ```bash
-# List all items
+# List all MCP servers
 bun run cli list
 
 # List with options
 bun run cli list --filter "category" --limit 20
 
-# Get item by ID
-bun run cli get <item-id>
+# Get MCP server by ID
+bun run cli get <server-id>
 
-# Search items
+# Search MCP servers
 bun run cli search "query" --limit 10
 
-# Add item
-bun run cli add --name "Item Name" --description "Description"
+# Add MCP server
+bun run cli add --name "Server Name" --description "Description"
 
-# Add item with metadata
-bun run cli add --name "Item" --metadata '{"key": "value"}'
+# 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 <item-id>
+bun run cli install <server-id>
 
 # Install to specific target
-bun run cli install <item-id> --target claude
-bun run cli install <item-id> --target codex
+bun run cli install <server-id> --target claude
+bun run cli install <server-id> --target codex
 
-# Install multiple items
+# Install multiple servers
 bun run cli install <id1> <id2> <id3>
 
 # Force overwrite
-bun run cli install <item-id> --force
+bun run cli install <server-id> --force
 
-# Clear installed items
+# Clear installed servers
 bun run cli install --clear
 
-# List installed items
+# List installed servers
 bun run cli install --list
 ```
 
@@ -161,8 +161,8 @@ POST /api/items
 Content-Type: application/json
 
 {
-  "name": "Item name",
-  "description": "Item description",
+  "name": "Server name",
+  "description": "Server description",
   "metadata": {"key": "value"}
 }
 ```
@@ -177,7 +177,8 @@ Content-Type: application/json
 │   ├── lib/
 │   │   ├── api-client.ts   # API client functions
 │   │   ├── config.ts       # Configuration management
-│   │   └── installer.ts    # Claude/Codex installer
+│   │   ├── installer.ts    # Claude/Codex installer
+│   │   └── service-dir.ts  # Service directory management
 │   ├── db/
 │   │   └── index.ts        # Database connection
 │   └── server/
@@ -202,8 +203,8 @@ Content-Type: application/json
 
 ## License
 
-MIT
+Apache-2.0
 
 ## Author
 
-{{author}}
+Hasna

package/skills/skill-managemcp/package.json

@@ -1,10 +1,10 @@
 {
-  "name": "service-{{name}}",
+  "name": "skill-managemcp",
   "version": "0.1.0",
   "type": "module",
-  "description": "{{description}}",
+  "description": "Manage MCP servers - list, install, remove, and configure MCP server connections",
   "bin": {
-    "{{name}}": "./bin/cli.ts"
+    "managemcp": "./bin/cli.ts"
   },
   "scripts": {
     "dev": "bun run --watch src/server/index.ts",
@@ -15,13 +15,12 @@
     "db:reset": "bun run scripts/migrate.ts && bun run scripts/seed.ts"
   },
   "dependencies": {
-    "commander": "^13.0.0",
     "postgres": "^3.4.5"
   },
   "devDependencies": {
     "@types/bun": "^1.1.14",
     "typescript": "^5.7.2"
   },
-  "author": "{{author}}",
-  "license": "MIT"
+  "author": "Hasna",
+  "license": "Apache-2.0"
 }

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

@@ -5,10 +5,10 @@ function getConnectionString(): string {
 
   const {
     DB_USER = 'postgres',
-    DB_PASSWORD = 'postgres',
+    DB_PASSWORD = '',
     DB_HOST = 'localhost',
     DB_PORT = '5432',
-    DB_NAME = 'app_db',
+    DB_NAME = 'managemcp_db',
   } = process.env;
 
   return `postgres://${DB_USER}:${DB_PASSWORD}@${DB_HOST}:${DB_PORT}/${DB_NAME}`;

package/skills/skill-managemcp/src/lib/api-client.ts

@@ -40,11 +40,11 @@ async function makeRequest<T>(
   const apiKey = await getApiKey();
 
   if (!apiUrl) {
-    throw new ApiError('API URL not configured. Run: {{name}} config --set-api-url <url>');
+    throw new ApiError('API URL not configured. Run: managemcp config --set-api-url <url>');
   }
 
   if (!apiKey) {
-    throw new ApiError('API key not configured. Run: {{name}} config --set-api-key <key>');
+    throw new ApiError('API key not configured. Run: managemcp config --set-api-key <key>');
   }
 
   const url = `${apiUrl}${endpoint}`;

package/skills/skill-managemcp/src/lib/config.ts

@@ -7,7 +7,7 @@ export interface Config {
   apiKey?: string;
 }
 
-export const CONFIG_FILE = join(homedir(), '.{{name}}.json');
+export const CONFIG_FILE = join(homedir(), '.managemcp.json');
 
 export async function loadConfig(): Promise<Config> {
   try {

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

@@ -2,7 +2,7 @@ import { existsSync, mkdirSync, writeFileSync, appendFileSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
 
-const SERVICE_NAME = "service-{{name}}";
+const SERVICE_NAME = "skill-managemcp";
 const SERVICE_DIR_NAME = `.${SERVICE_NAME}`;
 
 export function getServiceDir(): string {
@@ -72,7 +72,7 @@ This directory contains local configuration and logs for \`${SERVICE_NAME}\`.
 
 ## What is ${SERVICE_NAME}?
 
-\`${SERVICE_NAME}\` is a {{description}}.
+\`${SERVICE_NAME}\` is a tool for managing MCP server connections.
 
 ## Log File
 

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

@@ -1,7 +1,7 @@
 import { sql, testConnection, closeConnection } from '../db';
 
 const PORT = parseInt(process.env.PORT || '3000');
-const PATH_PREFIX = '/{{name}}';
+const PATH_PREFIX = '/managemcp';
 const API_KEY = process.env.API_KEY || '';
 
 // API Key validation
@@ -38,7 +38,7 @@ async function handleRequest(req: Request): Promise<Response> {
     if (pathname === '/health' && method === 'GET') {
       return Response.json({
         status: 'ok',
-        service: 'service-{{name}}',
+        service: 'skill-managemcp',
         timestamp: new Date().toISOString(),
       });
     }

package/skills/skill-managemcp/tsconfig.json

@@ -1,21 +1,29 @@
 {
+  "extends": "../tsconfig.base.json",
   "compilerOptions": {
     "target": "ESNext",
     "module": "ESNext",
-    "lib": ["ESNext"],
-    "moduleResolution": "bundler",
+    "lib": [
+      "ESNext"
+    ],
     "allowImportingTsExtensions": true,
     "moduleDetection": "force",
     "noEmit": true,
-    "strict": true,
-    "skipLibCheck": true,
     "noUnusedLocals": true,
     "noUnusedParameters": true,
     "noFallthroughCasesInSwitch": true,
     "allowSyntheticDefaultImports": true,
     "forceConsistentCasingInFileNames": true,
-    "types": ["bun"]
+    "types": [
+      "bun"
+    ]
   },
-  "include": ["src/**/*", "bin/**/*", "scripts/**/*"],
-  "exclude": ["node_modules"]
+  "include": [
+    "src/**/*",
+    "bin/**/*",
+    "scripts/**/*"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
 }

package/skills/skill-manageskill/.env.example

@@ -1,9 +1,9 @@
 # Database (individual connection params)
 DB_HOST=localhost
 DB_PORT=5432
-DB_NAME={{name}}_db
+DB_NAME=manageskill_db
 DB_USER=postgres
-DB_PASSWORD=postgres
+DB_PASSWORD=your-password-here
 
 # Or use a full connection string
 # DATABASE_URL=postgres://user:password@host:port/dbname

package/skills/skill-manageskill/CLAUDE.md

@@ -1,159 +1,48 @@
 # CLAUDE.md
 
-Claude-specific instructions for working with this codebase.
+Claude-specific instructions for working with the manageskill codebase.
 
-## CRITICAL: This is a SCAFFOLD Template
+## Overview
 
-**This is NOT a real project yet.** It's a scaffold template with placeholder variables.
+`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.
 
-### Placeholders to Replace
+## Architecture
 
-- `{{name}}` - Service name (e.g., "prompt", "billing")
-- `{{description}}` - Service description
-- `{{author}}` - Author name/email
+- **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`
 
-### Transformation Process
+## Key Directories
 
-When creating a new service from this scaffold:
+- `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
 
-1. Replace all occurrences of `{{name}}` with the actual service name
-2. Replace all occurrences of `{{description}}` with a real description
-3. Replace all occurrences of `{{author}}` with author information
-4. Test the transformed service
-5. **Update this file (CLAUDE.md)** to remove scaffold references and add project-specific instructions
-6. **Update AGENTS.md** with actual project details
-7. Remove or archive .template-vars
-
-### Files Requiring Replacement
-
-- package.json
-- .env.example
-- bin/cli.ts
-- src/lib/config.ts
-- README.md
-
-## Project Type: Service Scaffold
-
-This is a TypeScript service template combining:
-- **CLI tool** (Commander.js) - Command-line interface
-- **API server** (Bun HTTP) - REST API endpoints
-- **Database** (PostgreSQL) - Data persistence
-
-## Key Architectural Decisions
-
-### 1. CLI-Centric Design
-
-The CLI is the primary interface. The API server is secondary and can be run independently.
-
-### 2. Dual Configuration
-
-- **CLI config:** Stored in `~/.{{name}}.json` for user-specific settings
-- **Server config:** Uses environment variables from `.env`
-
-### 3. Database-First
-
-All operations interact with PostgreSQL. No in-memory caching or state management.
-
-### 4. Simple Installer
-
-The `install` command deploys items to Claude/Codex directories (`~/.claude/` and `~/.codex/`).
-
-## Claude Code Guidelines
+## Guidelines
 
 ### DO:
-- Follow the existing code structure (bin/, src/lib/, src/server/, scripts/)
 - 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
-- Follow the naming convention: service-{{name}}
 - Keep CLI commands focused and single-purpose
 - Use environment variables for secrets, config files for preferences
 
 ### DON'T:
-- Don't create new top-level directories
 - 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
-- Don't break the CLI pattern established in bin/cli.ts
-- Don't modify placeholder syntax if still in scaffold mode
 
 ## Common Operations
 
-### Adding a New CLI Command
-
-1. Open `bin/cli.ts`
-2. Add new command using Commander.js pattern
-3. Import necessary functions from src/lib/
-4. Add error handling
-5. Update README.md with usage examples
-
-### Adding a New API Endpoint
-
-1. Open `src/server/index.ts`
-2. Add route handling in `handleRequest` function
-3. Use database queries via `sql` tagged template
-4. Return JSON responses with proper status codes
-5. Update README.md with endpoint documentation
-
-### Adding Database Operations
-
-1. Create or modify files in src/lib/
-2. Import `sql` from '../db'
-3. Use parameterized queries: `sql\`SELECT * FROM table WHERE id = \${id}\``
-4. Handle errors appropriately
-5. Export functions for use in CLI or server
-
-### Database Migrations
-
-1. Edit `scripts/migrate.ts` to add new tables or columns
-2. Run `bun run db:migrate`
-3. Update seed data in `scripts/seed.ts` if needed
-4. Test with `bun run db:reset`
-
-## Testing Approach
-
-This scaffold doesn't include a test framework. When adding tests:
-- Use Bun's built-in test runner (`bun test`)
-- Create a `test/` directory
-- Test CLI commands, API endpoints, and database operations separately
-- Use a separate test database
-
-## Repository Context
-
-- **Owner:** Hasna
-- **Organization:** Hasna
-- **Repository pattern:** scaffold-service (follows `scaffold-<name>` convention)
-
-## After Transformation
-
-Once this scaffold becomes a real project (e.g., service-prompt, service-billing):
-
-1. **Update this file** with:
-   - Actual project name and description
-   - Project-specific architectural notes
-   - Domain-specific guidelines
-   - Integration points with other services
-   - Deployment instructions
-
-2. **Update AGENTS.md** with:
-   - Concrete examples from the real project
-   - Business logic documentation
-   - API integration details
-   - Common troubleshooting steps
-
-3. **Keep documentation current** as the project evolves
-
-## Questions to Ask
-
-If Claude is unclear about:
-- Which service this should become (prompt, billing, etc.)
-- Database schema requirements
-- External API integrations
-- Deployment targets
-
-**Ask the user for clarification before proceeding.**
-
-## Remember
-
-This is a scaffold. Treat it as a template until placeholders are replaced. Once transformed, update these docs to reflect the real project.
+```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,12 +1,12 @@
-# service-{{name}}
+# skill-manageskill
 
-{{description}}
+Manage Claude Code skills - list, install, remove, and configure skills.
 
-A TypeScript service template with CLI, API client, and database integration.
+A TypeScript service with CLI, API client, and database integration.
 
 ## Features
 
-- CLI tool for managing items
+- CLI tool for managing skills
 - HTTP server with REST API
 - PostgreSQL database with migrations
 - Configuration management
@@ -34,9 +34,9 @@ Edit `.env` file with your configuration:
 # Database
 DB_HOST=localhost
 DB_PORT=5432
-DB_NAME={{name}}_db
+DB_NAME=manageskill_db
 DB_USER=postgres
-DB_PASSWORD=postgres
+DB_PASSWORD=your-password-here
 
 # Server
 PORT=3000
@@ -93,48 +93,48 @@ bun run start
 bun run cli setup
 ```
 
-### Managing Items
+### Managing Skills
 
 ```bash
-# List all items
+# List all skills
 bun run cli list
 
 # List with options
 bun run cli list --filter "category" --limit 20
 
-# Get item by ID
-bun run cli get <item-id>
+# Get skill by ID
+bun run cli get <skill-id>
 
-# Search items
+# Search skills
 bun run cli search "query" --limit 10
 
-# Add item
-bun run cli add --name "Item Name" --description "Description"
+# Add skill
+bun run cli add --name "Skill Name" --description "Description"
 
-# Add item with metadata
-bun run cli add --name "Item" --metadata '{"key": "value"}'
+# 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 <item-id>
+bun run cli install <skill-id>
 
 # Install to specific target
-bun run cli install <item-id> --target claude
-bun run cli install <item-id> --target codex
+bun run cli install <skill-id> --target claude
+bun run cli install <skill-id> --target codex
 
-# Install multiple items
+# Install multiple skills
 bun run cli install <id1> <id2> <id3>
 
 # Force overwrite
-bun run cli install <item-id> --force
+bun run cli install <skill-id> --force
 
-# Clear installed items
+# Clear installed skills
 bun run cli install --clear
 
-# List installed items
+# List installed skills
 bun run cli install --list
 ```
 
@@ -161,8 +161,8 @@ POST /api/items
 Content-Type: application/json
 
 {
-  "name": "Item name",
-  "description": "Item description",
+  "name": "Skill name",
+  "description": "Skill description",
   "metadata": {"key": "value"}
 }
 ```
@@ -177,7 +177,8 @@ Content-Type: application/json
 │   ├── lib/
 │   │   ├── api-client.ts   # API client functions
 │   │   ├── config.ts       # Configuration management
-│   │   └── installer.ts    # Claude/Codex installer
+│   │   ├── installer.ts    # Claude/Codex installer
+│   │   └── service-dir.ts  # Service directory management
 │   ├── db/
 │   │   └── index.ts        # Database connection
 │   └── server/
@@ -202,8 +203,8 @@ Content-Type: application/json
 
 ## License
 
-MIT
+Apache-2.0
 
 ## Author
 
-{{author}}
+Hasna

package/skills/skill-manageskill/package.json

@@ -1,10 +1,10 @@
 {
-  "name": "service-{{name}}",
+  "name": "skill-manageskill",
   "version": "0.1.0",
   "type": "module",
-  "description": "{{description}}",
+  "description": "Manage Claude Code skills - list, install, remove, and configure skills",
   "bin": {
-    "{{name}}": "./bin/cli.ts"
+    "manageskill": "./bin/cli.ts"
   },
   "scripts": {
     "dev": "bun run --watch src/server/index.ts",
@@ -15,13 +15,12 @@
     "db:reset": "bun run scripts/migrate.ts && bun run scripts/seed.ts"
   },
   "dependencies": {
-    "commander": "^13.0.0",
     "postgres": "^3.4.5"
   },
   "devDependencies": {
     "@types/bun": "^1.1.14",
     "typescript": "^5.7.2"
   },
-  "author": "{{author}}",
-  "license": "MIT"
+  "author": "Hasna",
+  "license": "Apache-2.0"
 }

package/skills/skill-manageskill/src/db/index.ts

@@ -5,10 +5,10 @@ function getConnectionString(): string {
 
   const {
     DB_USER = 'postgres',
-    DB_PASSWORD = 'postgres',
+    DB_PASSWORD = '',
     DB_HOST = 'localhost',
     DB_PORT = '5432',
-    DB_NAME = 'app_db',
+    DB_NAME = 'manageskill_db',
   } = process.env;
 
   return `postgres://${DB_USER}:${DB_PASSWORD}@${DB_HOST}:${DB_PORT}/${DB_NAME}`;

package/skills/skill-manageskill/src/lib/api-client.ts

@@ -40,11 +40,11 @@ async function makeRequest<T>(
   const apiKey = await getApiKey();
 
   if (!apiUrl) {
-    throw new ApiError('API URL not configured. Run: {{name}} config --set-api-url <url>');
+    throw new ApiError('API URL not configured. Run: manageskill config --set-api-url <url>');
   }
 
   if (!apiKey) {
-    throw new ApiError('API key not configured. Run: {{name}} config --set-api-key <key>');
+    throw new ApiError('API key not configured. Run: manageskill config --set-api-key <key>');
   }
 
   const url = `${apiUrl}${endpoint}`;

package/skills/skill-manageskill/src/lib/config.ts

@@ -7,7 +7,7 @@ export interface Config {
   apiKey?: string;
 }
 
-export const CONFIG_FILE = join(homedir(), '.{{name}}.json');
+export const CONFIG_FILE = join(homedir(), '.manageskill.json');
 
 export async function loadConfig(): Promise<Config> {
   try {

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

@@ -2,7 +2,7 @@ import { existsSync, mkdirSync, writeFileSync, appendFileSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
 
-const SERVICE_NAME = "service-{{name}}";
+const SERVICE_NAME = "skill-manageskill";
 const SERVICE_DIR_NAME = `.${SERVICE_NAME}`;
 
 export function getServiceDir(): string {
@@ -72,7 +72,7 @@ This directory contains local configuration and logs for \`${SERVICE_NAME}\`.
 
 ## What is ${SERVICE_NAME}?
 
-\`${SERVICE_NAME}\` is a {{description}}.
+\`${SERVICE_NAME}\` is a tool for managing Claude Code skills.
 
 ## Log File