@hasna/skills 0.1.32 → 0.1.34

package/skills/deepresearch/SKILL.md

@@ -1,50 +1,41 @@
 ---
 name: deepresearch
-description: Perform deep research on any topic using Exa.ai for parallel semantic search and Claude/OpenAI for synthesis. Use when you need comprehensive research reports with citations, analysis of topics from multiple angles, or thorough investigation of technical subjects.
+description: Run hosted deep research with parallel search, synthesis, citations, source notes, and downloadable report artifacts.
 ---
 
 # Deep Research
 
-Agentic deep research skill using Exa.ai for search and Claude/OpenAI for synthesis.
+Deep Research is a hosted premium skill. The OSS package exposes public
+metadata and usage guidance only; search providers, model routing, prompts,
+worker orchestration, and credentials stay server-side.
 
-## Invocation
+## Usage
 
-```
-/deepresearch <topic>
+```bash
+skills setup --mode hosted
+skills auth login
+skills run deepresearch "Best practices for building production RAG systems" --depth normal
+skills runs status <run-id>
+skills exports download <run-id>
 ```
 
 ## Options
 
 | Option | Description | Default |
-|--------|-------------|---------|
-| `--depth <level>` | Research depth: quick (6 queries), normal (15), deep (30) | normal |
-| `--model <provider>` | LLM: claude or openai | claude |
-| `--output <path>` | Custom output path | ~/.skills/deepresearch/exports/ |
-| `--json` | Also save sources as JSON | false |
-| `--no-firecrawl` | Skip deep scraping | false |
-
-## Examples
-
-```bash
-# Quick overview of a topic
-/deepresearch "What is RAG?" --depth quick
-
-# Standard research with Claude
-/deepresearch "Best practices for building production ML systems"
-
-# Deep research with OpenAI, custom output
-/deepresearch "Compare Next.js vs Remix" --depth deep --model openai --output ./research.md
-```
+| --- | --- | --- |
+| `--depth <level>` | Research depth: `quick`, `normal`, or `deep` | `normal` |
+| `--output <path>` | Requested output path inside the exported artifact bundle | hosted export |
+| `--json` | Request raw source metadata in the exported bundle | `false` |
 
 ## Requirements
 
-- `EXA_API_KEY` - Required for search
-- `ANTHROPIC_API_KEY` - Required for Claude synthesis
-- `OPENAI_API_KEY` - Required for OpenAI synthesis
-- `FIRECRAWL_API_KEY` - Optional for deep scraping
+- Authenticate with `skills auth login` or provide `SKILLS_API_KEY`.
+- Provider credentials are managed by the hosted runtime and are not part of the
+  OSS package.
 
-## Output
+## Outputs
 
-Reports are saved to `~/.skills/deepresearch/exports/` with format:
-- `report-{topic-slug}-{timestamp}.md` - Full research report
-- `sources-{topic-slug}-{timestamp}.json` - Raw sources (if --json)
+- Research report
+- Source notes
+- Citation metadata
+- Run manifest

package/skills/deepresearch/package.json

@@ -1,44 +1,11 @@
 {
   "name": "deepresearch",
   "version": "0.1.3",
+  "private": true,
   "description": "Agentic deep research skill using Exa.ai for search and Claude/OpenAI for synthesis",
   "type": "module",
-  "main": "src/index.ts",
-  "bin": {
-    "deepresearch": "src/index.ts"
-  },
-  "files": [
-    "src",
-    "README.md",
-    "SKILL.md"
-  ],
-  "publishConfig": {
-    "access": "restricted"
-  },
-  "keywords": [
-    "research",
-    "ai",
-    "exa",
-    "claude",
-    "openai",
-    "rag",
-    "deep-research"
-  ],
-  "scripts": {
-    "start": "bun run src/index.ts",
-    "dev": "bun --watch src/index.ts",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@anthropic-ai/sdk": "^0.30.0",
-    "chalk": "^5.3.0",
-    "commander": "^12.1.0",
-    "exa-js": "^1.0.12",
-    "openai": "^4.0.0",
-    "ora": "^8.0.1"
-  },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.7.0"
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
   }
 }

package/skills/domainpurchase/SKILL.md

@@ -1,46 +1,29 @@
 ---
 name: domainpurchase
-description: Purchase and manage domains via GoDaddy API with CLI and HTTP server
+description: Public contract for domain purchase workflows through hosted or external registrar connectors.
 ---
 
 # Domain Purchase
 
-Purchase and manage domains via the GoDaddy API. Provides both a CLI tool and an HTTP server for domain purchasing workflows.
-
-## Features
-
-- Purchase domains through GoDaddy API
-- Manage domain configurations and settings
-- HTTP server mode for API-driven purchases
-- AWS Secrets Manager integration for credential storage
-- Remote server proxy mode for centralized domain management
+This public skill describes domain purchase and management workflows for agents.
+The OSS package intentionally does not ship registrar purchasing logic, remote
+server proxy code, or cloud secret-store integration.
 
 ## Usage
 
 ```bash
-# Run the CLI
-domainpurchase
-
-# Start the HTTP server
-bun run start
-
-# Development mode with watch
-bun run dev
+skills run domainpurchase --help
 ```
 
-## Environment Variables
+For production domain purchase workflows, route execution through a hosted or
+external connector that owns registrar credentials, audit logs, payment
+approval, and account-specific policy.
 
-| Variable | Description |
-|----------|-------------|
-| `DOMAIN_API_KEY` | GoDaddy API key |
-| `DOMAIN_API_SECRET` | GoDaddy API secret |
-| `DOMAIN_CUSTOMER_ID` | GoDaddy customer ID |
-| `DOMAIN_API_URL` | API base URL (default: `https://api.godaddy.com`) |
-| `DOMAIN_USE_REMOTE_SERVER` | Use remote server proxy (`true`/`false`) |
-| `DOMAIN_REMOTE_SERVER_URL` | Remote server URL |
-| `DOMAIN_REMOTE_API_KEY` | Remote server API key |
-| `AWS_SECRET_NAME` | AWS Secrets Manager secret name for credentials |
+## Boundary
 
-## Configuration
+- Local package: skill metadata, docs, and a CLI stub.
+- Hosted or external connector: registrar API calls, credentials, approvals,
+  purchase records, and billing-sensitive workflows.
 
-Config is stored at `~/.config/service-domainpurchase/config.json`. Environment variables take priority over the config file. AWS Secrets Manager is also supported as a credential source.
+Provider credentials and cloud secret names must not be stored in this OSS
+skill package.

package/skills/domainpurchase/package.json

@@ -2,7 +2,7 @@
   "name": "domainpurchase",
   "version": "0.1.3",
   "type": "module",
-  "description": "CLI tool and HTTP API for purchasing and managing domains via GoDaddy API",
+  "description": "Public domain purchase skill contract and local CLI stub",
   "private": true,
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
@@ -12,8 +12,8 @@
     "domainpurchase": "src/index.ts"
   },
   "files": [
-    "bin",
     "src",
+    "SKILL.md",
     "tsconfig.json"
   ],
   "homepage": "https://github.com/hasnaxyz/domainpurchase#readme",
@@ -21,12 +21,7 @@
     "url": "https://github.com/hasnaxyz/domainpurchase/issues"
   },
   "scripts": {
-    "dev": "bun run --watch src/server/index.ts",
-    "start": "bun run src/server/index.ts",
-    "cli": "bun run bin/cli.ts"
-  },
-  "dependencies": {
-    "@aws-sdk/client-secrets-manager": "^3.700.0"
+    "start": "bun run src/index.ts"
   },
   "devDependencies": {
     "@types/bun": "^1.1.14",

package/skills/email-sequence/package.json

@@ -1,14 +1,11 @@
 {
   "name": "email-sequence",
   "version": "0.1.0",
+  "private": true,
   "description": "Hosted premium email sequence artifact generator",
   "type": "module",
-  "bin": {
-    "email-sequence": "./src/index.ts"
-  },
-  "dependencies": {},
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.7.0"
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
   }
 }

package/skills/generate-book-cover/package.json

@@ -1,29 +1,11 @@
 {
   "name": "generate-book-cover",
   "version": "0.1.0",
+  "private": true,
   "description": "Generate Book Cover skill",
   "type": "module",
-  "bin": {
-    "generate-book-cover": "./src/index.ts"
-  },
-  "scripts": {
-    "dev": "bun run src/index.ts",
-    "build": "bun build src/index.ts --outdir dist --target node",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "openai": "^4.77.0"
-  },
-  "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/icon-pack/package.json

@@ -1,29 +1,11 @@
 {
   "name": "icon-pack",
   "version": "0.1.0",
+  "private": true,
   "description": "Generate a coordinated icon pack as SVGs and transparent PNGs",
   "type": "module",
-  "main": "src/index.ts",
-  "bin": {
-    "icon-pack": "src/index.ts"
-  },
-  "files": [
-    "README.md",
-    "SKILL.md"
-  ],
-  "publishConfig": {
-    "access": "restricted"
-  },
-  "keywords": [
-    "icons",
-    "icon-pack",
-    "svg",
-    "png",
-    "design"
-  ],
-  "scripts": {
-    "start": "bun run src/index.ts",
-    "dev": "bun --watch src/index.ts",
-    "typecheck": "tsc --noEmit"
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
   }
 }

package/skills/image/README.md

@@ -1,195 +1,25 @@
-# Image Generation Skill
+# Image Generation
 
-A Claude Code skill for generating images using multiple AI providers: OpenAI DALL-E 3, Google Imagen 3, and xAI Aurora.
-
-## Features
-
-- Multiple AI providers in one unified interface
-- Clean, type-safe TypeScript implementation
-- Simple CLI interface
-- Native Bun runtime (no external dependencies)
-- Support for custom models and sizes
-- Automatic image download and saving
-
-## Installation
-
-```bash
-cd image
-bun install
-```
-
-## Configuration
-
-Set up your API keys as environment variables:
-
-```bash
-# OpenAI
-export OPENAI_API_KEY="your-openai-api-key"
-
-# Google Gemini
-export GEMINI_API_KEY="your-gemini-api-key"
-export GOOGLE_PROJECT_ID="your-google-project-id"
-
-# xAI
-export XAI_API_KEY="your-xai-api-key"
-```
+Hosted image generation skill with provider-cost pricing and downloadable image
+artifacts.
 
 ## Usage
 
-### Basic Commands
-
 ```bash
-# OpenAI DALL-E 3
-bun run src/index.ts generate --provider openai --prompt "a cat" --output ./cat.png
-
-# Google Imagen 3
-bun run src/index.ts generate --provider google --prompt "a dog" --output ./dog.png
-
-# xAI Aurora
-bun run src/index.ts generate --provider xai --prompt "a bird" --output ./bird.png
-```
-
-### Advanced Options
-
-```bash
-# Custom size with OpenAI
-bun run src/index.ts generate \
-  --provider openai \
-  --prompt "a futuristic cityscape" \
-  --output ./city.png \
-  --size 1792x1024
-
-# Custom model
-bun run src/index.ts generate \
-  --provider openai \
-  --prompt "abstract art" \
-  --output ./art.png \
-  --model dall-e-3
-
-# Google Imagen with aspect ratio
-bun run src/index.ts generate \
-  --provider google \
-  --prompt "mountain landscape" \
-  --output ./mountain.png \
-  --size 16:9
+skills setup --mode hosted
+skills auth login
+skills run image "editorial product photo on a white sweep"
 ```
 
-### Short Flags
-
-```bash
-bun run src/index.ts generate \
-  -p openai \
-  --prompt "a sunset" \
-  -o ./sunset.png \
-  -s 1024x1024
-```
-
-## Provider Details
-
-### OpenAI DALL-E 3
-
-- **Endpoint**: `https://api.openai.com/v1/images/generations`
-- **Models**:
-  - `dall-e-3` (default) - Latest DALL-E model
-  - `gpt-image-1` - GPT-4o image generation
-- **Sizes**:
-  - `1024x1024` (default, square)
-  - `1792x1024` (landscape)
-  - `1024x1792` (portrait)
-- **Features**: High-quality, detailed images with prompt revision
-
-### Google Imagen 3
-
-- **Endpoint**: Vertex AI REST API
-- **Model**: `imagen-3.0-generate-001`
-- **Aspect Ratios**:
-  - `1:1` (default, square)
-  - `3:4` (portrait)
-  - `4:3` (landscape)
-  - `9:16` (vertical)
-  - `16:9` (wide)
-- **Features**: Photorealistic images with excellent quality
-
-### xAI Grok-2 Image
-
-- **Endpoint**: `https://api.x.ai/v1/images/generations`
-- **Model**: `grok-2-image-1212` (Grok's image generator)
-- **Features**: Text-to-image with creative interpretation
-- **Price**: $0.07 per image
-
-## Project Structure
-
-```
-image/
-├── SKILL.md              # Skill metadata with YAML frontmatter
-├── README.md             # This file
-├── package.json          # Bun package configuration
-├── tsconfig.json         # TypeScript configuration
-└── src/
-    ├── index.ts          # Main CLI entry point
-    ├── types.ts          # TypeScript type definitions
-    └── providers/
-        ├── openai.ts     # OpenAI DALL-E provider
-        ├── google.ts     # Google Imagen provider
-        └── xai.ts        # xAI Aurora provider
-```
-
-## Development
-
-The code is written in TypeScript and uses native Bun APIs:
-
-- `fetch` for HTTP requests (built into Bun)
-- File system operations via `fs/promises`
-- No external dependencies for image generation
-
-## Error Handling
-
-The skill includes comprehensive error handling:
-
-- API key validation
-- HTTP error responses
-- Invalid parameter detection
-- File system errors
-- Network failures
-
-## Examples
-
-### Generate a photorealistic image
-
-```bash
-bun run src/index.ts generate \
-  --provider google \
-  --prompt "a photorealistic portrait of a woman with red hair, studio lighting, professional photography" \
-  --output ./portrait.png
-```
-
-### Generate concept art
-
-```bash
-bun run src/index.ts generate \
-  --provider openai \
-  --prompt "concept art of a sci-fi spaceship, detailed, artstation trending" \
-  --output ./spaceship.png \
-  --size 1792x1024
-```
-
-### Generate creative interpretation
-
-```bash
-bun run src/index.ts generate \
-  --provider xai \
-  --prompt "the feeling of nostalgia as abstract art" \
-  --output ./nostalgia.png
-```
-
-## Help
-
-View help information:
+Poll and download results:
 
 ```bash
-bun run src/index.ts --help
+skills runs status <run-id>
+skills exports download <run-id>
 ```
 
-## License
+## Boundary
 
-MIT
+The OSS package contains metadata, pricing, and client contracts only. Provider
+credentials, model routing, prompts, moderation, billing, worker code, and
+artifact storage are owned by the hosted platform.

package/skills/image/package.json

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

package/skills/invoice-reconciliation/package.json

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

package/skills/landing-page-pack/package.json

@@ -1,14 +1,11 @@
 {
   "name": "landing-page-pack",
   "version": "0.1.0",
+  "private": true,
   "description": "Hosted premium landing page copy and conversion artifact generator",
   "type": "module",
-  "bin": {
-    "landing-page-pack": "./src/index.ts"
-  },
-  "dependencies": {},
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.7.0"
+  "skills": {
+    "runtime": "hosted",
+    "source": "remote"
   }
 }

package/skills/logo-design/package.json

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

package/skills/managemcp/CLAUDE.md

@@ -1,48 +1,14 @@
-# CLAUDE.md
+# Manage MCP
 
-Claude-specific instructions for working with the managemcp codebase.
+Use this skill as a public contract for MCP server management workflows.
 
-## Overview
-
-`managemcp` is a TypeScript service for managing MCP (Model Context Protocol) servers. It provides a CLI tool, REST API server, and PostgreSQL database for listing, installing, removing, and configuring MCP server connections.
-
-## 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 `~/.managemcp.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
+Do not copy this skill into agent-native skill folders. Register the shared
+Skills MCP server instead:
 
 ```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)
+skills mcp --register all
 ```
+
+The OSS package does not include a database-backed MCP catalog service,
+migrations, hosted API server, or installer implementation. Those concerns
+belong in the hosted platform or an external MCP management service.