@hasna/skills 0.1.27 → 0.1.30

package/skills/mcp-builder/src/minimist.d.ts

@@ -0,0 +1,15 @@
+declare module "minimist" {
+  export interface ParsedArgs {
+    _: string[];
+    [key: string]: any;
+  }
+
+  export interface Options {
+    string?: string[];
+    boolean?: string[];
+    default?: Record<string, unknown>;
+    alias?: Record<string, string | string[]>;
+  }
+
+  export default function minimist(args?: string[], opts?: Options): ParsedArgs;
+}

package/skills/mcp-builder/src/naming.ts

@@ -0,0 +1,12 @@
+export function toPascalCase(name: string): string {
+  return name
+    .split(/[-_]/)
+    .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+    .join("");
+}
+
+export function toSnakeCase(name: string): string {
+  return name.replace(/-/g, "_");
+}
+
+// Generate TypeScript project

package/skills/mcp-builder/src/options.ts

@@ -0,0 +1,170 @@
+import * as fs from "fs";
+import minimist from "minimist";
+
+import { TEMPLATES } from "./templates";
+import type { BuildOptions, PromptDef, ResourceDef, ToolDef } from "./types";
+
+export function parseBuildOptions(argv = process.argv.slice(2)): BuildOptions {
+  const args = minimist(argv, {
+    string: ["language", "template", "tools", "tool-file", "resources", "resource-file", "prompts", "prompt-file", "output"],
+    boolean: ["overwrite", "ai-descriptions", "with-tests", "with-docker", "help"],
+    default: {
+      language: "typescript",
+    },
+    alias: {
+      o: "output",
+      h: "help",
+    },
+  });
+
+  // Show help
+  if (args.help || args._.length === 0) {
+    console.log(`
+  MCP Builder - Generate MCP server projects
+
+  Usage:
+    skills run mcp-builder -- <name> [options]
+
+  Basic Options:
+    <name>                  Server name (required)
+    --language <lang>       Language: typescript, python (default: typescript)
+    --template <name>       Template: weather, database, api, filesystem
+
+  Tool Options:
+    --tools <list>          Comma-separated tool names
+    --tool-file <path>      JSON file with tool definitions
+
+  Resource Options:
+    --resources <list>      Comma-separated resource URIs
+    --resource-file <path>  JSON file with resource definitions
+
+  Prompt Options:
+    --prompts <list>        Comma-separated prompt names
+    --prompt-file <path>    JSON file with prompt definitions
+
+  Output Options:
+    -o, --output <path>     Output directory (default: ./<name>)
+    --overwrite             Overwrite existing files
+
+  Generation Options:
+    --ai-descriptions       Generate descriptions with AI
+    --with-tests            Include test files
+    --with-docker           Include Dockerfile
+    -h, --help              Show this help message
+
+  Examples:
+    skills run mcp-builder -- my-server --tools "search,fetch,analyze"
+    skills run mcp-builder -- weather-mcp --template weather
+    skills run mcp-builder -- api-server --tool-file tools.json --language python
+  `);
+    process.exit(0);
+  }
+
+  // Get server name
+  const serverName = args._[0] as string;
+  if (!serverName) {
+    console.error("Error: Server name is required");
+    process.exit(1);
+  }
+
+  // Validate name
+  if (!/^[a-z][a-z0-9-]*$/.test(serverName)) {
+    console.error("Error: Server name must start with a letter and contain only lowercase letters, numbers, and hyphens");
+    process.exit(1);
+  }
+
+  // Parse tool names into definitions
+  function parseToolNames(names: string): ToolDef[] {
+    return names.split(",").map((name) => ({
+      name: name.trim().replace(/\s+/g, "_"),
+      description: `TODO: Add description for ${name.trim()}`,
+      parameters: {},
+    }));
+  }
+
+  // Parse resource URIs into definitions
+  function parseResourceURIs(uris: string): ResourceDef[] {
+    return uris.split(",").map((uri) => ({
+      uri: uri.trim(),
+      name: uri.trim().split("://")[1] || uri.trim(),
+      description: `TODO: Add description`,
+      mimeType: "application/json",
+    }));
+  }
+
+  // Parse prompt names into definitions
+  function parsePromptNames(names: string): PromptDef[] {
+    return names.split(",").map((name) => ({
+      name: name.trim().replace(/\s+/g, "_"),
+      description: `TODO: Add description for ${name.trim()}`,
+      arguments: [],
+    }));
+  }
+
+  // Load definitions from file
+  function loadFromFile<T>(filePath: string): T[] {
+    if (!fs.existsSync(filePath)) {
+      console.error(`Error: File not found: ${filePath}`);
+      process.exit(1);
+    }
+    const content = fs.readFileSync(filePath, "utf-8");
+    const data = JSON.parse(content);
+    return Array.isArray(data) ? data : data.tools || data.resources || data.prompts || [];
+  }
+
+  // Build options
+  const options: BuildOptions = {
+    name: serverName,
+    language: args.language as BuildOptions["language"],
+    template: args.template || null,
+    tools: [],
+    resources: [],
+    prompts: [],
+    output: args.output || `./${serverName}`,
+    overwrite: args.overwrite,
+    aiDescriptions: args["ai-descriptions"],
+    withTests: args["with-tests"],
+    withDocker: args["with-docker"],
+  };
+
+  // Load template if specified
+  if (options.template) {
+    const template = TEMPLATES[options.template];
+    if (!template) {
+      console.error(`Error: Unknown template: ${options.template}`);
+      console.error(`Available templates: ${Object.keys(TEMPLATES).join(", ")}`);
+      process.exit(1);
+    }
+    options.tools = [...template.tools];
+    options.resources = [...template.resources];
+    options.prompts = [...template.prompts];
+  }
+
+  // Add tools from arguments
+  if (args.tools) {
+    options.tools.push(...parseToolNames(args.tools));
+  }
+  if (args["tool-file"]) {
+    options.tools.push(...loadFromFile<ToolDef>(args["tool-file"]));
+  }
+
+  // Add resources from arguments
+  if (args.resources) {
+    options.resources.push(...parseResourceURIs(args.resources));
+  }
+  if (args["resource-file"]) {
+    options.resources.push(...loadFromFile<ResourceDef>(args["resource-file"]));
+  }
+
+  // Add prompts from arguments
+  if (args.prompts) {
+    options.prompts.push(...parsePromptNames(args.prompts));
+  }
+  if (args["prompt-file"]) {
+    options.prompts.push(...loadFromFile<PromptDef>(args["prompt-file"]));
+  }
+
+  // Generate AI descriptions
+
+  return options;
+}

package/skills/mcp-builder/src/templates.ts

@@ -0,0 +1,149 @@
+import type { PromptDef, ResourceDef, ToolDef } from "./types";
+
+export const TEMPLATES: Record<string, { tools: ToolDef[]; resources: ResourceDef[]; prompts: PromptDef[] }> = {
+  weather: {
+    tools: [
+      {
+        name: "get_current_weather",
+        description: "Get current weather conditions for a location",
+        parameters: {
+          location: { type: "string", description: "City name or coordinates", required: true },
+          units: { type: "string", description: "Temperature units: celsius or fahrenheit", default: "celsius" },
+        },
+      },
+      {
+        name: "get_forecast",
+        description: "Get weather forecast for the next few days",
+        parameters: {
+          location: { type: "string", description: "City name or coordinates", required: true },
+          days: { type: "number", description: "Number of days to forecast", default: 5 },
+        },
+      },
+    ],
+    resources: [{ uri: "weather://locations", name: "Saved Locations", description: "List of saved weather locations", mimeType: "application/json" }],
+    prompts: [{ name: "weather_summary", description: "Generate a weather summary", arguments: [{ name: "location", description: "Location to summarize", required: true }] }],
+  },
+  database: {
+    tools: [
+      {
+        name: "query",
+        description: "Execute a SQL query and return results",
+        parameters: {
+          sql: { type: "string", description: "SQL query to execute", required: true },
+          params: { type: "array", description: "Query parameters", items: { type: "string" } },
+        },
+      },
+      {
+        name: "insert",
+        description: "Insert a record into a table",
+        parameters: {
+          table: { type: "string", description: "Table name", required: true },
+          data: { type: "object", description: "Data to insert", required: true },
+        },
+      },
+      {
+        name: "update",
+        description: "Update records in a table",
+        parameters: {
+          table: { type: "string", description: "Table name", required: true },
+          data: { type: "object", description: "Data to update", required: true },
+          where: { type: "string", description: "WHERE clause", required: true },
+        },
+      },
+      {
+        name: "delete",
+        description: "Delete records from a table",
+        parameters: {
+          table: { type: "string", description: "Table name", required: true },
+          where: { type: "string", description: "WHERE clause", required: true },
+        },
+      },
+    ],
+    resources: [
+      { uri: "db://schema", name: "Database Schema", description: "Database schema information", mimeType: "application/json" },
+      { uri: "db://tables", name: "Tables List", description: "List of all tables", mimeType: "application/json" },
+    ],
+    prompts: [],
+  },
+  api: {
+    tools: [
+      {
+        name: "get",
+        description: "Make a GET request to an API endpoint",
+        parameters: {
+          url: { type: "string", description: "API endpoint URL", required: true },
+          headers: { type: "object", description: "Request headers" },
+        },
+      },
+      {
+        name: "post",
+        description: "Make a POST request to an API endpoint",
+        parameters: {
+          url: { type: "string", description: "API endpoint URL", required: true },
+          body: { type: "object", description: "Request body", required: true },
+          headers: { type: "object", description: "Request headers" },
+        },
+      },
+      {
+        name: "put",
+        description: "Make a PUT request to an API endpoint",
+        parameters: {
+          url: { type: "string", description: "API endpoint URL", required: true },
+          body: { type: "object", description: "Request body", required: true },
+          headers: { type: "object", description: "Request headers" },
+        },
+      },
+      {
+        name: "delete",
+        description: "Make a DELETE request to an API endpoint",
+        parameters: {
+          url: { type: "string", description: "API endpoint URL", required: true },
+          headers: { type: "object", description: "Request headers" },
+        },
+      },
+    ],
+    resources: [],
+    prompts: [],
+  },
+  filesystem: {
+    tools: [
+      {
+        name: "read_file",
+        description: "Read contents of a file",
+        parameters: {
+          path: { type: "string", description: "File path", required: true },
+          encoding: { type: "string", description: "File encoding", default: "utf-8" },
+        },
+      },
+      {
+        name: "write_file",
+        description: "Write contents to a file",
+        parameters: {
+          path: { type: "string", description: "File path", required: true },
+          content: { type: "string", description: "Content to write", required: true },
+          encoding: { type: "string", description: "File encoding", default: "utf-8" },
+        },
+      },
+      {
+        name: "list_directory",
+        description: "List contents of a directory",
+        parameters: {
+          path: { type: "string", description: "Directory path", required: true },
+          recursive: { type: "boolean", description: "List recursively", default: false },
+        },
+      },
+      {
+        name: "search_files",
+        description: "Search for files matching a pattern",
+        parameters: {
+          pattern: { type: "string", description: "Search pattern (glob)", required: true },
+          path: { type: "string", description: "Starting directory", default: "." },
+        },
+      },
+    ],
+    resources: [{ uri: "file://{path}", name: "File Content", description: "Content of a file", mimeType: "text/plain" }],
+    prompts: [],
+  },
+};
+
+// Parse arguments

package/skills/mcp-builder/src/types.ts

@@ -0,0 +1,42 @@
+export interface ToolDef {
+  name: string;
+  description: string;
+  parameters: Record<string, ParameterDef>;
+}
+
+export interface ParameterDef {
+  type: "string" | "number" | "boolean" | "array" | "object";
+  description: string;
+  required?: boolean;
+  default?: any;
+  items?: { type: string };
+}
+
+export interface ResourceDef {
+  uri: string;
+  name: string;
+  description: string;
+  mimeType?: string;
+}
+
+export interface PromptDef {
+  name: string;
+  description: string;
+  arguments?: { name: string; description: string; required?: boolean }[];
+}
+
+export interface BuildOptions {
+  name: string;
+  language: "typescript" | "python";
+  template: string | null;
+  tools: ToolDef[];
+  resources: ResourceDef[];
+  prompts: PromptDef[];
+  output: string;
+  overwrite: boolean;
+  aiDescriptions: boolean;
+  withTests: boolean;
+  withDocker: boolean;
+}
+
+// Templates

package/skills/meeting-pack/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: meeting-pack
+description: Generate premium meeting artifact packs from transcripts or notes with summaries, decisions, action items, owner/deadline tables, follow-up email, project export, timeline, and manifest metadata.
+---
+
+# Meeting Pack
+
+Generate a complete meeting artifact package from transcripts, notes, call summaries, or rough bullets.
+
+## Requirements
+
+- Authenticate with `skills auth login`.
+- This premium skill runs through the hosted Skills runtime; local installs expose only metadata and instructions.
+
+## Usage
+
+```bash
+skills run meeting-pack --notes "Discussed billing launch, docs, and support owner follow-ups" --meeting "Billing Launch Sync"
+skills run meeting-pack ./transcript.txt --participants "Hasna,Alex,Sam" --format executive
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--notes <text>` | Meeting transcript, rough notes, or summary. Positional text also works. | required unless `--source` is used |
+| `--source <path>` | Read notes or transcript from a file. | none |
+| `--meeting <text>` | Meeting title. | Meeting |
+| `--participants <list>` | Comma-separated participant names. | Team |
+| `--format <type>` | `project`, `executive`, `sales`, or `standup`. | project |
+| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+
+## Outputs
+
+- `meeting-summary.md`
+- `decisions.md`
+- `action-items.csv`
+- `follow-up-email.md`
+- `project-export.json`
+- `timeline.md`
+- `manifest.json`
+
+After submitting a hosted run, poll with `skills runs status <run-id>` and download outputs with `skills exports download <run-id>`.

package/skills/meeting-pack/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "meeting-pack",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Hosted premium meeting artifact package generator",
+  "type": "module",
+  "bin": {
+    "meeting-pack": "./src/index.ts"
+  }
+}

package/skills/merge-pdfs/package.json

@@ -11,7 +11,11 @@
     "build": "bun build src/index.ts --outdir dist --target node",
     "typecheck": "tsc --noEmit"
   },
-  "dependencies": {},
+  "dependencies": {
+    "pdf-lib": "^1.17.1",
+    "minimist": "^1.2.8",
+    "glob": "^11.1.0"
+  },
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5.7.0"

package/skills/migration-plan-pack/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: migration-plan-pack
+description: Generate premium migration planning packs for framework, library, database, infrastructure, or architecture upgrades with risk matrix, checklist, rollout plan, and test strategy.
+---
+
+# Migration Plan Pack
+
+Generate a migration package from current state, target state, system context, and operating constraints. Hosted runs can inspect richer project inputs, while local direct execution produces deterministic artifacts for validation.
+
+## Requirements
+
+- Authenticate with `skills auth login`.
+- This premium skill runs through the hosted Skills runtime; local installs expose only metadata and instructions.
+
+## Usage
+
+```bash
+skills run migration-plan-pack --system "Acme SaaS" --from "Next.js 14, Postgres 14" --to "Next.js 16, Postgres 16"
+skills run migration-plan-pack --from "single-region worker" --to "multi-region worker" --constraints "no downtime, preserve RLS"
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--system <text>` | Product, repo, app, or service being migrated. | Migration Target |
+| `--from <text>` | Current framework, library, database, infrastructure, or architecture state. | current state |
+| `--to <text>` | Desired target state. | target state |
+| `--scope <list>` | Comma-separated systems or workstreams in scope. | app, data, deploy, tests |
+| `--constraints <text>` | Risk, downtime, compliance, billing, or operational constraints. | optional |
+| `--deadline <text>` | Date, release train, or migration window. | optional |
+| `--strategy <type>` | `phased`, `big-bang`, or `parallel-run`. | phased |
+| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+
+## Outputs
+
+- `migration-plan.md`
+- `risk-matrix.csv`
+- `ordered-checklist.md`
+- `test-strategy.md`
+- `dependency-map.json`
+- `rollout-plan.md`
+- `manifest.json`
+
+After submitting a hosted run, poll with `skills runs status <run-id>` and download outputs with `skills exports download <run-id>`.

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

@@ -0,0 +1,10 @@
+{
+  "name": "migration-plan-pack",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Hosted premium migration planning pack generator",
+  "type": "module",
+  "bin": {
+    "migration-plan-pack": "./src/index.ts"
+  }
+}

package/skills/music/package.json

@@ -2,6 +2,7 @@
   "name": "music",
   "version": "1.0.0",
   "description": "Generate music using provider-cost AI backends",
+  "main": "src/index.ts",
   "type": "module",
   "bin": {
     "music": "src/index.ts"
@@ -17,10 +18,8 @@
     "gemini",
     "lyria"
   ],
-  "dependencies": {},
   "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.0.0"
+    "@types/bun": "latest"
   },
   "peerDependencies": {
     "typescript": "^5.0.0"

package/skills/music-album/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: music-album
+description: Generate hosted music album packages with 7, 14, or 21 songs
+---
+
+# Music Album
+
+Create a hosted premium album package from a concept, genre, mood, or campaign brief. The hosted runtime generates a cohesive album plan, 7, 14, or 21 songs, cover art direction, track metadata, manifests, receipts, and downloadable artifacts.
+
+## Usage
+
+```bash
+skills run music-album "ambient synth album for deep work" --songs 7
+skills run music-album "high-energy product launch soundtrack" --songs 14 --genre "electro pop"
+skills run music-album "cinematic fantasy travel album" --songs 21 --lyrics-mode instrumental
+```
+
+## Options
+
+- `--songs <7|14|21>`: Album size.
+- `--genre <text>`: Genre or style lane.
+- `--lyrics-mode <instrumental|vocal|mixed>`: Lyric direction.
+- `--cover-style <text>`: Cover art direction.
+- `--reference <path-or-url>`: Optional brand, mood, or story reference.
+
+## Output
+
+- `album/track-*.mp3` or provider-native audio files
+- `album/cover.png`
+- `album/tracklist.json`
+- `album/manifest.json`
+- `album/receipt.json`
+
+## Requirements
+
+Hosted premium execution requires `SKILLS_API_KEY` or `skills auth login`.
+Provider keys stay server-side.

package/skills/music-album/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "music-album",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Hosted premium music album package generator",
+  "type": "module",
+  "bin": {
+    "music-album": "./src/index.ts"
+  }
+}

package/skills/notion-manager/package.json

@@ -11,7 +11,9 @@
     "build": "bun build src/index.ts --outdir dist --target node",
     "typecheck": "tsc --noEmit"
   },
-  "dependencies": {},
+  "dependencies": {
+    "@notionhq/client": "^5.4.0"
+  },
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5.7.0"

package/skills/npmpublish/CLAUDE.md

@@ -18,16 +18,13 @@ bun run src/index.ts
 ## Project Structure
 
 - `src/index.ts` - CLI entry point
-- `SKILL.md` - Claude Code / Codex skill definition
+- `SKILL.md` - bundled skill instructions served through Skills CLI/MCP
 
-## Skill Installation
+## Agent Integration
 
-For Claude Code:
-```bash
-ln -s $(pwd) ~/.claude/skills/npmpublish
-```
+Do not copy or symlink this skill into agent-native skill folders. Register the
+root Skills MCP server instead:
 
-For Codex:
 ```bash
-ln -s $(pwd) ~/.codex/skills/npmpublish
+skills mcp --register all
 ```

package/skills/npmpublish/README.md

@@ -4,7 +4,7 @@ Publish npm packages with sensible defaults:
 - **Private by default** - Sets `publishConfig.access: restricted`
 - **Patch bump by default** - Increments version by 0.0.1 (not 0.1.0)
 
-Works as both a **Claude Code** skill and **OpenAI Codex** skill.
+Use it directly as a CLI, or expose it to agents through the root Skills MCP server.
 
 ## Installation
 
@@ -16,36 +16,15 @@ bun add -g @hasnaxyz/npmpublish
 bunx @hasnaxyz/npmpublish
 ```
 
-### Claude Code Skill
+### Agent Integration
 
-Link to Claude Code skills directory:
-```bash
-ln -s ~/Workspace/dev/hasnaxyz/skill/skilldev/npmpublish ~/.claude/skills/npmpublish
-```
+Do not symlink, copy, or install this skill into agent-native skill folders.
+Register the shared Skills MCP server instead:
 
-Or copy the SKILL.md:
 ```bash
-mkdir -p ~/.claude/skills/npmpublish
-cp SKILL.md ~/.claude/skills/npmpublish/
+skills mcp --register all
 ```
 
-Then invoke with `/npmpublish` in Claude Code.
-
-### OpenAI Codex Skill
-
-Link to Codex skills directory:
-```bash
-ln -s ~/Workspace/dev/hasnaxyz/skill/skilldev/npmpublish ~/.codex/skills/npmpublish
-```
-
-Or for project-specific:
-```bash
-mkdir -p .codex/skills/npmpublish
-cp SKILL.md .codex/skills/npmpublish/
-```
-
-Then invoke with `/npmpublish` in Codex.
-
 ## Usage
 
 ```bash