@hasna/skills 0.1.27 → 0.1.29

package/skills/implementation-agent/src/types.ts

@@ -0,0 +1,53 @@
+export interface PromptSection {
+  title: string;
+  content?: string;
+  items?: string[];
+}
+
+export interface AgentJsonData {
+  description?: string;
+  tools?: string[];
+  model?: "sonnet" | "opus" | "haiku" | "inherit";
+  permissionMode?: "default" | "acceptEdits" | "bypassPermissions" | "plan" | "ignore";
+  skills?: string[];
+  sections?: PromptSection[];
+}
+
+export interface AgentData {
+  id: string;
+  slug: string;
+  name: string;
+  description: string;
+  tools: string[];
+  model: string;
+  permissionMode: string;
+  skills: string[];
+  prompt: string;
+  created: string;
+  updated: string;
+  isGlobal: boolean;
+  jsonData?: AgentJsonData;
+}
+
+export interface AgentTemplate {
+  name: string;
+  description: string;
+  tools: string[];
+  model: string;
+  prompt: string;
+}
+
+
+export interface GeneratedAgent {
+  name: string;
+  slug: string;
+  description: string;
+  tools: string[];
+  model: string;
+  prompt: string;
+}
+
+export interface AIGenerationResult {
+  agents: GeneratedAgent[];
+  reasoning: string;
+}

package/skills/implementation-plan/package.json

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

package/skills/implementation-todo/package.json

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

package/skills/invoice/package.json

@@ -4,7 +4,7 @@
   "description": "Invoice generator CLI",
   "type": "module",
   "bin": {
-    "invoice": "./bin/cli.ts"
+    "invoicegenerate": "src/index.ts"
   },
   "scripts": {
     "start": "bun run bin/cli.ts",

package/skills/invoice/src/index.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+
+console.log("Usage: skills run invoice -- <command> [options]");

package/skills/invoice-reconciliation/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: invoice-reconciliation
+description: Generate premium invoice reconciliation reports from invoice, payment, purchase order, or CSV/XLSX-style exports with matches, discrepancies, anomaly notes, summaries, and manifest metadata.
+---
+
+# Invoice Reconciliation
+
+Generate a reconciliation package from invoice and payment exports. The hosted run produces matched rows, discrepancy tables, anomaly notes, and a management-ready report.
+
+## 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 invoice-reconciliation --invoices ./invoices.csv --payments ./payments.csv --company "Acme"
+skills run invoice-reconciliation --data "invoice_id,customer,amount,status\nINV-1,Acme,1200,open" --currency USD
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--invoices <path>` | CSV export with invoice rows. | optional |
+| `--payments <path>` | CSV export with payment rows. | optional |
+| `--data <text>` | Inline invoice/payment CSV-style data. Positional text also works. | optional |
+| `--company <text>` | Company or finance workspace name. | Company |
+| `--currency <code>` | Currency code for output amounts. | USD |
+| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+
+## Outputs
+
+- `reconciliation-report.md`
+- `matched-invoices.csv`
+- `discrepancies.csv`
+- `anomalies.json`
+- `summary.json`
+- `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/invoice-reconciliation/package.json

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

package/skills/landing-page-pack/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: landing-page-pack
+description: Generate premium landing page copy, wireframes, CTA maps, experiments, and preview artifacts.
+---
+
+# Landing Page Pack
+
+Generate a conversion-focused landing page package for a product, service, or offer.
+
+## Requirements
+
+- Authenticate with `skills auth login`.
+- This premium skill runs through the hosted Skills runtime; local installs expose only skill metadata and instructions.
+
+## Usage
+
+```bash
+skills run landing-page-pack "Usage-based billing for AI SaaS" --audience "founders" --goal "book demos"
+skills run landing-page-pack --product "API monitoring" --offer "Find broken API workflows before customers do"
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--product <text>` | Product, service, or campaign brief. Positional text also works. | required |
+| `--audience <text>` | Primary buyer or user segment. | software teams |
+| `--offer <text>` | Core offer or promise. | derived from product |
+| `--goal <text>` | Main conversion goal. | book demos |
+| `--tone <tone>` | `direct`, `premium`, `friendly`, or `technical`. | direct |
+| `--proof <text>` | Proof points, metrics, or trust signals. | case studies and testimonials |
+| `--sections <list>` | Comma-separated section names. | hero, problem, solution, proof, faq, cta |
+| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+
+## Outputs
+
+- `landing-page.md`
+- `copy-blocks.json`
+- `wireframe.md`
+- `preview.html`
+- `style-guide.md`
+- `cta-map.csv`
+- `experiment-plan.md`
+- `implementation-notes.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/landing-page-pack/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "landing-page-pack",
+  "version": "0.1.0",
+  "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"
+  }
+}

package/skills/latex-table-generator/package.json

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

package/skills/logo-design/SKILL.md

@@ -1,56 +1,43 @@
 ---
 name: logo-design
-description: Generate professional logos using AI (OpenAI GPT Image, Google Gemini Nano Banana)
+description: Generate premium multi-variant logo packages with transparent PNG exports, vector-style SVGs, usage notes, and a manifest.
 ---
 
-# Logo Design Skill
+# Logo Design
 
-Generate professional logo designs from text descriptions using multiple AI image providers via the connectors REST API.
+Generate professional logo concepts from a text brief. Hosted runs return a downloadable brand exploration package.
 
-## Providers
+## Requirements
 
-### OpenAI GPT Image
-- **Model**: gpt-image-1
-- **Sizes**: 1024x1024, 1536x1024, 1024x1536
-- **Best for**: Clean vector-style logos, text rendering, minimal designs
-- **Connector**: `openai` (requires API key configured)
-
-### Google Gemini (Nano Banana)
-- **Model**: gemini-2.5-flash-preview-image-generation
-- **Sizes**: Configurable aspect ratios (1:1, 16:9, 9:16)
-- **Best for**: Creative exploration, stylized concepts, detailed compositions
-- **Connector**: `googlegemini` (requires API key configured)
+- Authenticate with `skills auth login`.
+- This premium skill runs through the hosted Skills runtime; local installs expose only metadata and instructions.
 
 ## Usage
 
 ```bash
-# Generate with OpenAI GPT Image (default)
-logo-design generate "minimalist geometric owl logo, flat vector, navy and gold, white background"
-
-# Generate with Gemini
-logo-design generate --provider gemini "modern tech startup logo, abstract hexagon, clean lines"
-
-# Save to specific file
-logo-design generate --output ./my-logo.png "coffee shop logo, vintage style, warm tones"
-
-# Generate multiple variations
-logo-design generate --variations 4 "mountain peak logo, minimalist, black and white"
-
-# List available providers and their status
-logo-design providers
+skills run logo-design --brief "minimal geometric owl mark for a developer tool" --brand "Acme"
+skills run logo-design "coffee shop logo, vintage badge, warm tones" --variations 4
 ```
 
 ## Options
 
 | Flag | Description | Default |
 |------|-------------|---------|
-| `--provider` | Provider: `openai` or `gemini` | `openai` |
-| `--output` / `-o` | Output file path | `./logo_{timestamp}.png` |
-| `--variations` / `-n` | Number of variations | `1` |
-| `--size` / `-s` | Image size (OpenAI: 1024x1024, etc.) | `1024x1024` |
-| `--aspect-ratio` / `-a` | Aspect ratio for Gemini (1:1, 16:9) | `1:1` |
-| `--quality` / `-q` | Quality level (openai: standard/hd) | `hd` |
-| `--server` | Connectors server URL | `http://localhost:19426` |
+| `--brief <text>` | Logo brief. Positional text also works. | required |
+| `--brand <name>` | Brand or product name. | Brand |
+| `--style <text>` | Visual style direction. | clean vector mark |
+| `--palette <list>` | Comma-separated color direction. | navy,white,accent |
+| `--variations <n>` | Number of logo concepts, 1-6. | 3 |
+| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+
+## Outputs
+
+- `transparent/logo-*.png`
+- `vector/logo-*.svg`
+- `concepts.json`
+- `logo-brief.md`
+- `usage-notes.md`
+- `manifest.json`
 
 ## Logo Design Tips
 
@@ -58,13 +45,7 @@ logo-design providers
 2. **Specify style**: flat vector, 3D, vintage, modern, hand-drawn, geometric, abstract
 3. **Request white/solid background**: Prevents complex backgrounds bleeding into the mark
 4. **Keep it simple**: Logos must work at favicon size (16x16). Ask for clean, minimal designs
-5. **Skip text in the logo**: AI models struggle with typography. Generate the icon, add text in Illustrator/Figma
+5. **Skip text in the logo**: Generators struggle with typography. Generate the icon, add text in Illustrator/Figma
 6. **Generate many variations**: Run 4-10 variations with slight prompt tweaks, pick the best
 
-## Prerequisites
-
-The connectors server must be running with OpenAI and/or Google Gemini connectors configured:
-
-```bash
-connectors serve    # Start connectors server on port 19426
-```
+After submitting a hosted run, poll with `skills runs status <run-id>` and download outputs with `skills exports download <run-id>`.

package/skills/logo-design/package.json

@@ -1,21 +1,9 @@
 {
   "name": "logo-design",
-  "version": "1.0.0",
-  "description": "Generate professional logos using AI image providers",
+  "version": "0.1.0",
+  "private": true,
   "type": "module",
-  "main": "src/index.ts",
   "bin": {
-    "logo-design": "src/index.ts"
-  },
-  "scripts": {
-    "start": "bun run src/index.ts",
-    "generate": "bun run src/index.ts generate"
-  },
-  "dependencies": {
-    "chalk": "^5.3.0",
-    "commander": "^12.1.0"
-  },
-  "devDependencies": {
-    "@types/bun": "latest"
+    "logo-design": "./src/index.ts"
   }
 }

package/skills/lorem-generator/package.json

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

package/skills/lorem-generator/src/index.ts

@@ -2,6 +2,19 @@
 import { LoremIpsum } from "lorem-ipsum";
 
 const args = process.argv.slice(2);
+if (args.includes("--help") || args.includes("-h")) {
+  console.log(`lorem-generator
+
+Usage:
+  lorem-generator count=<number> units=<paragraphs|sentences|words> [format=<text|html|markdown>]
+
+Options:
+  count=<number>   Number of units to generate
+  units=<units>    paragraphs, sentences, or words
+  format=<format>  text, html, or markdown`);
+  process.exit(0);
+}
+
 const countArg = args.find(a => a.startsWith("count="))?.split("=")[1] || "1";
 const unitsArg = args.find(a => a.startsWith("units="))?.split("=")[1] || "paragraphs";
 const formatArg = args.find(a => a.startsWith("format="))?.split("=")[1] || "text";

package/skills/managehook/package.json

@@ -4,7 +4,7 @@
   "type": "module",
   "description": "Manage Claude Code hooks - list, install, remove, and configure hooks",
   "bin": {
-    "managehook": "./bin/cli.ts"
+    "managehook": "src/index.ts"
   },
   "scripts": {
     "dev": "bun run --watch src/server/index.ts",

package/skills/managehook/src/index.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+
+console.log("Usage: skills run managehook -- <command> [options]");

package/skills/managemcp/package.json

@@ -4,7 +4,7 @@
   "type": "module",
   "description": "Manage MCP servers - list, install, remove, and configure MCP server connections",
   "bin": {
-    "managemcp": "./bin/cli.ts"
+    "managemcp": "src/index.ts"
   },
   "scripts": {
     "dev": "bun run --watch src/server/index.ts",

package/skills/managemcp/src/index.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+
+console.log("Usage: skills run managemcp -- <command> [options]");

package/skills/manageskill/package.json

@@ -4,7 +4,7 @@
   "type": "module",
   "description": "Manage Claude Code skills - list, install, remove, and configure skills",
   "bin": {
-    "manageskill": "./bin/cli.ts"
+    "manageskill": "src/index.ts"
   },
   "scripts": {
     "dev": "bun run --watch src/server/index.ts",

package/skills/manageskill/src/index.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+
+console.log("Usage: skills run manageskill -- <command> [options]");

package/skills/markdown-validator/package.json

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

package/skills/markdown-validator/src/index.ts

@@ -1,10 +1,7 @@
 #!/usr/bin/env bun
 import { readFile, readdir } from "fs/promises";
 import { join } from "path";
-import markdownlint from "markdownlint";
-import { promisify } from "util";
-
-const markdownlintAsync = promisify(markdownlint);
+import { lint as markdownlintAsync } from "markdownlint/async";
 
 function showHelp(): void {
   console.log(`

package/skills/market-research-report/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: market-research-report
+description: Generate a premium market research report with competitor, audience, pricing, source, Markdown, and PDF artifacts.
+---
+
+# Market Research Report
+
+Generate a market research report package for SaaS, developer tools, and business planning work.
+
+## 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 market-research-report --topic "AI developer tools" --audience "SaaS founders" --competitors "Cursor,Copilot,Replit"
+skills run market-research-report "B2B onboarding analytics" --region "US/EU" --format strategic
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--topic <text>` | Market, product category, or research question. Positional text also works. | required |
+| `--audience <text>` | Target audience or buyer segment. | Operators and founders |
+| `--competitors <list>` | Comma-separated competitor names. | inferred examples |
+| `--region <text>` | Geographic or commercial scope. | Global |
+| `--format <format>` | `strategic`, `investor`, or `product`. | strategic |
+| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+
+## Outputs
+
+- `market-research-report.md`
+- `market-research-report.pdf`
+- `competitors.csv`
+- `sources.json`
+- `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/market-research-report/package.json

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

package/skills/mcp-builder/package.json

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

package/skills/mcp-builder/src/ai-descriptions.ts

@@ -0,0 +1,37 @@
+import OpenAI from "openai";
+
+import type { BuildOptions } from "./types";
+
+export async function generateDescriptions(options: BuildOptions): Promise<void> {
+  const apiKey = process.env.OPENAI_API_KEY;
+  if (!apiKey) {
+    console.warn("Warning: OPENAI_API_KEY not set, skipping AI descriptions");
+    return;
+  }
+
+  const openai = new OpenAI({ apiKey });
+
+  console.log("Generating AI descriptions...");
+
+  for (const tool of options.tools) {
+    if (tool.description.startsWith("TODO:")) {
+      const response = await openai.chat.completions.create({
+        model: "gpt-4o-mini",
+        messages: [
+          {
+            role: "system",
+            content: "Generate a concise, clear description for an MCP tool. One sentence, no markdown.",
+          },
+          {
+            role: "user",
+            content: `Tool name: ${tool.name}\nParameters: ${JSON.stringify(tool.parameters)}`,
+          },
+        ],
+        max_tokens: 100,
+      });
+      tool.description = response.choices[0]?.message?.content || tool.description;
+    }
+  }
+}
+
+// Convert name to various formats