@hasna/skills 0.1.32 → 0.1.34

package/skills/managemcp/README.md

@@ -1,210 +1,24 @@
-# managemcp
+# Manage MCP
 
-Manage MCP servers - list, install, remove, and configure MCP server connections.
+Public contract for managing MCP server connections.
 
-A TypeScript service with CLI, API client, and database integration.
+## Boundary
 
-## Features
+The OSS package keeps a lightweight CLI stub and documentation only. It does not
+ship a PostgreSQL service, REST API server, migration scripts, hosted registry,
+or agent-folder installer implementation.
 
-- 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
+Use the shared Skills MCP registration flow for agent integration:
 
 ```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"}'
+skills mcp --register all
 ```
 
-### Installation to Claude/Codex
+## Usage
 
 ```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
+skills run managemcp --help
 ```
 
-## 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
+Hosted MCP catalog state, account-scoped server listings, billing, and
+connector management belong in the hosted platform or an external service.

package/skills/managemcp/package.json

@@ -2,20 +2,12 @@
   "name": "managemcp",
   "version": "0.1.0",
   "type": "module",
-  "description": "Manage MCP servers - list, install, remove, and configure MCP server connections",
+  "description": "Public Manage MCP skill contract and local CLI stub",
   "bin": {
     "managemcp": "src/index.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"
+    "start": "bun run src/index.ts"
   },
   "devDependencies": {
     "@types/bun": "^1.1.14",

package/skills/managemcp/tsconfig.json

@@ -19,9 +19,7 @@
     ]
   },
   "include": [
-    "src/**/*",
-    "bin/**/*",
-    "scripts/**/*"
+    "src/**/*"
   ],
   "exclude": [
     "node_modules"

package/skills/market-research-report/package.json

@@ -1,10 +1,11 @@
 {
   "name": "market-research-report",
   "version": "0.1.0",
+  "private": true,
   "description": "Generate market research report artifacts through the hosted Skills runtime",
   "type": "module",
-  "bin": {
-    "market-research-report": "src/index.ts"
-  },
-  "dependencies": {}
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
+  }
 }

package/skills/meeting-pack/package.json

@@ -4,7 +4,8 @@
   "private": true,
   "description": "Hosted premium meeting artifact package generator",
   "type": "module",
-  "bin": {
-    "meeting-pack": "./src/index.ts"
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
   }
 }

package/skills/migration-plan-pack/package.json

@@ -4,7 +4,8 @@
   "private": true,
   "description": "Hosted premium migration planning pack generator",
   "type": "module",
-  "bin": {
-    "migration-plan-pack": "./src/index.ts"
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
   }
 }

package/skills/music/package.json

@@ -1,27 +1,11 @@
 {
   "name": "music",
   "version": "1.0.0",
+  "private": true,
   "description": "Generate music using provider-cost AI backends",
-  "main": "src/index.ts",
   "type": "module",
-  "bin": {
-    "music": "src/index.ts"
-  },
-  "scripts": {
-    "start": "bun run src/index.ts",
-    "generate": "bun run src/index.ts generate"
-  },
-  "keywords": [
-    "music-generation",
-    "ai",
-    "minimax",
-    "gemini",
-    "lyria"
-  ],
-  "devDependencies": {
-    "@types/bun": "latest"
-  },
-  "peerDependencies": {
-    "typescript": "^5.0.0"
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
   }
 }

package/skills/music-album/package.json

@@ -4,7 +4,8 @@
   "private": true,
   "description": "Hosted premium music album package generator",
   "type": "module",
-  "bin": {
-    "music-album": "./src/index.ts"
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
   }
 }

package/skills/one-page-website/package.json

@@ -4,7 +4,8 @@
   "private": true,
   "description": "Hosted premium one-page website bundle generator",
   "type": "module",
-  "bin": {
-    "one-page-website": "./src/index.ts"
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
   }
 }

package/skills/pdf-read/package.json

@@ -1,29 +1,11 @@
 {
   "name": "pdf-read",
   "version": "0.1.0",
+  "private": true,
   "description": "Read and extract text from PDF files with page-range selection and parallel processing",
   "type": "module",
-  "bin": {
-    "pdf-read": "./src/index.ts"
-  },
-  "scripts": {
-    "dev": "bun run src/index.ts",
-    "build": "bun build src/index.ts --outdir dist --target node",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "pdf-parse": "^1.1.1"
-  },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.7.0"
-  },
-  "publishConfig": {
-    "access": "restricted",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "files": [
-    "src",
-    "tsconfig.json"
-  ]
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
+  }
 }

package/skills/pdf-to-dataset/package.json

@@ -1,10 +1,11 @@
 {
   "name": "pdf-to-dataset",
   "version": "0.1.0",
+  "private": true,
   "description": "Extract PDF tables and forms into CSV and JSON datasets through the hosted Skills runtime",
   "type": "module",
-  "bin": {
-    "pdf-to-dataset": "src/index.ts"
-  },
-  "dependencies": {}
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
+  }
 }

package/skills/pdf-to-markdown/package.json

@@ -1,10 +1,11 @@
 {
   "name": "pdf-to-markdown",
   "version": "0.1.0",
+  "private": true,
   "description": "Convert PDFs into clean markdown through the hosted Skills runtime",
   "type": "module",
-  "bin": {
-    "pdf-to-markdown": "src/index.ts"
-  },
-  "dependencies": {}
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
+  }
 }

package/skills/performance-audit-report/package.json

@@ -4,7 +4,8 @@
   "private": true,
   "description": "Hosted premium performance audit report generator",
   "type": "module",
-  "bin": {
-    "performance-audit-report": "./src/index.ts"
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
   }
 }

package/skills/photo-album/package.json

@@ -2,8 +2,10 @@
   "name": "photo-album",
   "version": "0.1.0",
   "private": true,
+  "description": "Hosted skill metadata for photo-album",
   "type": "module",
-  "bin": {
-    "photo-album": "./src/index.ts"
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
   }
 }

package/skills/pitch-deck/package.json

@@ -1,9 +1,11 @@
 {
   "name": "pitch-deck",
   "version": "0.1.0",
-  "type": "module",
   "private": true,
-  "bin": {
-    "pitch-deck": "src/index.ts"
+  "description": "Hosted skill metadata for pitch-deck",
+  "type": "module",
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
   }
 }

package/skills/playlist-maker/package.json

@@ -2,8 +2,10 @@
   "name": "playlist-maker",
   "version": "0.1.0",
   "private": true,
+  "description": "Hosted skill metadata for playlist-maker",
   "type": "module",
-  "bin": {
-    "playlist-maker": "./src/index.ts"
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
   }
 }

package/skills/product-mockup/package.json

@@ -4,7 +4,8 @@
   "private": true,
   "description": "Hosted premium product mockup artifact generator",
   "type": "module",
-  "bin": {
-    "product-mockup": "./src/index.ts"
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
   }
 }

package/skills/proposal-pack/package.json

@@ -1,10 +1,11 @@
 {
   "name": "proposal-pack",
   "version": "0.1.0",
+  "private": true,
   "description": "Generate client proposal packages through the hosted Skills runtime",
   "type": "module",
-  "bin": {
-    "proposal-pack": "src/index.ts"
-  },
-  "dependencies": {}
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
+  }
 }

package/skills/read-pdf/package.json

@@ -1,36 +1,11 @@
 {
   "name": "read-pdf",
   "version": "0.1.0",
+  "private": true,
   "description": "Analyze PDFs with Claude document blocks and merge chunked output",
   "type": "module",
-  "main": "src/index.ts",
-  "bin": {
-    "read-pdf": "src/index.ts"
-  },
-  "files": [
-    "src",
-    "SKILL.md",
-    "tsconfig.json"
-  ],
-  "publishConfig": {
-    "access": "restricted"
-  },
-  "keywords": [
-    "pdf",
-    "claude",
-    "document",
-    "ocr",
-    "skill"
-  ],
-  "scripts": {
-    "start": "bun run src/index.ts",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "pdf-lib": "^1.17.1"
-  },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.7.0"
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
   }
 }

package/skills/remove-background/package.json

@@ -1,27 +1,11 @@
 {
   "name": "remove-background",
   "version": "0.1.0",
+  "private": true,
   "description": "Remove Background skill",
   "type": "module",
-  "bin": {
-    "remove-background": "./src/index.ts"
-  },
-  "scripts": {
-    "dev": "bun run src/index.ts",
-    "build": "bun build src/index.ts --outdir dist --target node",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {},
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.7.0"
-  },
-  "publishConfig": {
-    "access": "restricted",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "files": [
-    "src",
-    "tsconfig.json"
-  ]
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
+  }
 }

package/skills/repo-onboarding-report/package.json

@@ -4,7 +4,8 @@
   "private": true,
   "description": "Hosted premium repository onboarding report generator",
   "type": "module",
-  "bin": {
-    "repo-onboarding-report": "./src/index.ts"
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
   }
 }

package/skills/sdk-generator/package.json

@@ -4,7 +4,8 @@
   "private": true,
   "description": "Hosted premium SDK scaffold generator",
   "type": "module",
-  "bin": {
-    "sdk-generator": "./src/index.ts"
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
   }
 }

package/skills/security-audit-report/package.json

@@ -1,10 +1,11 @@
 {
   "name": "security-audit-report",
   "version": "0.1.0",
+  "private": true,
   "description": "Generate security hardening report artifacts through the hosted Skills runtime",
   "type": "module",
-  "bin": {
-    "security-audit-report": "src/index.ts"
-  },
-  "dependencies": {}
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
+  }
 }

package/skills/seo-content-pack/package.json

@@ -1,9 +1,11 @@
 {
   "name": "seo-content-pack",
   "version": "0.1.0",
-  "type": "module",
   "private": true,
-  "bin": {
-    "seo-content-pack": "src/index.ts"
+  "description": "Hosted skill metadata for seo-content-pack",
+  "type": "module",
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
   }
 }

package/skills/short-video-pack/package.json

@@ -4,7 +4,8 @@
   "private": true,
   "description": "Hosted premium short-form video package generator",
   "type": "module",
-  "bin": {
-    "short-video-pack": "./src/index.ts"
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
   }
 }

package/skills/slide-deck-generator/package.json

@@ -4,7 +4,8 @@
   "private": true,
   "description": "Hosted premium slide deck generator",
   "type": "module",
-  "bin": {
-    "slide-deck-generator": "./src/index.ts"
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
   }
 }