@hasna/skills 0.1.26 → 0.1.29

package/skills/contract-review-report/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: contract-review-report
+description: Generate premium contract review reports with clause summaries, risk register, negotiation points, redline-style suggestions, counterparty email draft, and manifest metadata.
+---
+
+# Contract Review Report
+
+Generate a structured contract review package from an agreement, terms sheet, statement of work, vendor contract, or customer contract.
+
+## 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 contract-review-report --source ./msa.txt --party "Acme" --counterparty "VendorCo"
+skills run contract-review-report --contract "Termination requires 90 days notice..." --focus "privacy,liability,payment"
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--contract <text>` | Contract text. Positional text also works. | required unless `--source` is used |
+| `--source <path>` | Read contract text from a file. | none |
+| `--party <text>` | Your company or client name. | Our company |
+| `--counterparty <text>` | Other party name. | Counterparty |
+| `--jurisdiction <text>` | Governing context for notes. | Not specified |
+| `--focus <list>` | Comma-separated focus areas. | liability,payment,termination,privacy |
+| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+
+## Outputs
+
+- `contract-review-report.md`
+- `risk-register.csv`
+- `clause-summary.json`
+- `redline-suggestions.md`
+- `negotiation-email.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/contract-review-report/package.json

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

package/skills/convert/SKILL.md

@@ -64,9 +64,8 @@ bun run src/index.ts formats
 - `@anthropic-ai/sdk` - Claude AI
 - `openai` - GPT-4o AI
 
-### API Keys (for AI features)
-- `ANTHROPIC_API_KEY` - For Claude-powered conversions
-- `OPENAI_API_KEY` - For GPT-4o-powered conversions
+### API Key
+- `SKILL_API_KEY` - Hosted runtime access. Provider credentials for AI features are managed remotely.
 
 ## Conversion Categories
 

package/skills/customer-feedback-report/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: customer-feedback-report
+description: Generate premium customer feedback reports from reviews, support tickets, surveys, call notes, or raw feedback with clusters, sentiment, root causes, roadmap recommendations, evidence, and manifest metadata.
+---
+
+# Customer Feedback Report
+
+Generate a structured customer feedback insight package from reviews, support tickets, survey responses, interview notes, sales call notes, or mixed raw feedback.
+
+## 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 customer-feedback-report --feedback "Users love onboarding but struggle with invoices and integrations" --product "Skills.md"
+skills run customer-feedback-report ./feedback.txt --product "Acme CRM" --channel tickets --format product
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--feedback <text>` | Raw feedback text. Positional text also works. | required unless `--source` is used |
+| `--source <path>` | Read feedback text from a file. | none |
+| `--product <text>` | Product, service, or workflow name. | Product |
+| `--segment <text>` | Customer segment or audience. | All customers |
+| `--channel <type>` | `reviews`, `tickets`, `calls`, `surveys`, or `mixed`. | mixed |
+| `--format <type>` | `product`, `support`, or `executive`. | product |
+| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+
+## Outputs
+
+- `customer-feedback-report.md`
+- `customer-feedback-report.pdf`
+- `feedback-clusters.csv`
+- `roadmap-suggestions.md`
+- `sentiment-summary.json`
+- `evidence.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/customer-feedback-report/package.json

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

package/skills/dashboard-builder/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/database-explorer/package.json

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

package/skills/deepresearch/README.md

@@ -21,24 +21,15 @@ cd ~/Workspace/dev/hasnaxyz/skill/skilldev/deepresearch
 bun install
 ```
 
-### Claude Code Skill
+### Agent Integration
 
-Link to Claude Code skills directory:
-```bash
-ln -s ~/Workspace/dev/hasnaxyz/skill/skilldev/deepresearch ~/.claude/skills/deepresearch
-```
-
-Then invoke with `/deepresearch "your topic"` in Claude Code.
+Do not symlink, copy, or install this skill into agent-native skill folders.
+Register the shared Skills MCP server instead:
 
-### OpenAI Codex Skill
-
-Link to Codex skills directory:
 ```bash
-ln -s ~/Workspace/dev/hasnaxyz/skill/skilldev/deepresearch ~/.codex/skills/deepresearch
+skills mcp --register all
 ```
 
-Then invoke with `/deepresearch "your topic"` in Codex.
-
 ## Configuration
 
 Set API keys in `~/.secrets`:

package/skills/deploy/src/http-client.ts

@@ -47,7 +47,7 @@ export async function executeSkill(request: SkillRequest): Promise<SkillResponse
       method: "POST",
       headers: {
         "Content-Type": "application/json",
-        "User-Agent": `${skill}-cli/1.0`,
+        "User-Agent": `skill-${skill}-cli/1.0`,
         "X-API-Key": apiKey
       },
       body: JSON.stringify(params)

package/skills/diff-viewer/package.json

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

package/skills/doc-generate/package.json

@@ -14,7 +14,6 @@
   "dependencies": {
     "docx": "^9.5.1",
     "marked": "^15.0.4",
-    "minimist": "^1.2.8",
     "openai": "^4.77.0"
   },
   "publishConfig": {

package/skills/doc-generate/src/ai.ts

@@ -0,0 +1,50 @@
+import { createOpenAIClient } from "./dependencies";
+import type { DocOptions } from "./types";
+
+export async function generateWithAI(options: DocOptions, topic: string, isPrompt = false): Promise<string> {
+  const apiKey = process.env.OPENAI_API_KEY;
+  if (!apiKey) {
+    throw new Error("OPENAI_API_KEY environment variable is required for AI generation");
+  }
+
+  const openai = await createOpenAIClient(apiKey);
+
+  const lengthGuide = {
+    short: "Keep it concise, around 500 words total.",
+    medium: "Write a moderate length document, around 1000-1500 words.",
+    long: "Write a comprehensive document, around 2000-3000 words.",
+    comprehensive: "Write a very detailed document, around 4000+ words with thorough coverage.",
+  };
+
+  const styleGuide = {
+    professional: "Use professional business language.",
+    casual: "Use a casual, conversational tone.",
+    formal: "Use formal, academic language.",
+    academic: "Use scholarly, well-researched language with citations where appropriate.",
+  };
+
+  const systemPrompt = isPrompt
+    ? `You are a professional document writer. Write in markdown format with proper headings, paragraphs, lists, and formatting. ${styleGuide[options.style]} ${lengthGuide[options.length]}`
+    : `You are a professional document writer creating a ${options.template} document. Write in markdown format with:
+- A clear title (# Title)
+- ${options.sections} main sections (## Section headings)
+- Proper paragraphs, bullet points, and formatting as needed
+- ${styleGuide[options.style]}
+- ${lengthGuide[options.length]}
+
+Output ONLY the markdown content, no explanations.`;
+  const userPrompt = isPrompt ? topic : `Write a document about: ${topic}`;
+
+  console.log("Generating content with AI...");
+
+  const response = await openai.chat.completions.create({
+    model: "gpt-4o",
+    messages: [
+      { role: "system", content: systemPrompt },
+      { role: "user", content: userPrompt },
+    ],
+    temperature: 0.7,
+  });
+
+  return response.choices[0]?.message?.content || "";
+}

package/skills/doc-generate/src/cli.ts

@@ -0,0 +1,203 @@
+import type { CliResult, DocOptions } from "./types";
+
+const HELP = `
+Generate DOCX - Create Word documents from markdown or AI
+
+Usage:
+  skills run generate-docx -- <markdown-file> [options]
+  skills run generate-docx -- --topic "Topic" [options]
+  skills run generate-docx -- --prompt "Prompt" [options]
+
+Input Options:
+  <file>              Input markdown file
+  --topic <text>      Topic for AI to write about
+  --prompt <text>     Direct prompt for AI generation
+  --text <text>       Plain text content
+
+AI Options:
+  --sections <n>      Number of sections (default: 5)
+  --style <type>      Style: professional, casual, formal, academic
+  --tone <type>       Tone: neutral, friendly, authoritative
+  --length <type>     Length: short, medium, long, comprehensive
+
+Output Options:
+  -o, --output <path> Output file path
+  --dir <path>        Output directory (default: .skills/exports)
+
+Template Options:
+  --template <name>   Template: default, report, letter, memo, resume, article
+  --title <text>      Document title
+  --author <text>     Author name
+  --company <text>    Company name
+  --date <text>       Document date
+
+Styling Options:
+  --font <name>       Font family (default: Calibri)
+  --font-size <pt>    Base font size (default: 11)
+  --heading-font      Heading font (default: Calibri Light)
+  --line-spacing <n>  Line spacing (default: 1.15)
+  --margins <inches>  Page margins (default: 1)
+  --page-size <size>  Page size: letter, a4, legal
+
+Content Options:
+  --toc               Include table of contents
+  --page-numbers      Include page numbers (default: true)
+  --header <text>     Header text
+  --footer <text>     Footer text
+
+Examples:
+  skills run generate-docx -- document.md -o output.docx
+  skills run generate-docx -- --topic "Business Plan" --template report -o plan.docx
+  skills run generate-docx -- --prompt "Write a cover letter" --template letter
+`;
+
+type ParsedArgs = Record<string, string | number | boolean | undefined> & { _: string[] };
+
+const BOOLEAN_FLAGS = new Set(["toc", "page-numbers", "help"]);
+const ALIASES: Record<string, string> = {
+  h: "help",
+  o: "output",
+};
+
+const DEFAULT_ARGS: Omit<ParsedArgs, "_"> = {
+  dir: ".skills/exports",
+  template: "default",
+  font: "Calibri",
+  "font-size": 11,
+  "heading-font": "Calibri Light",
+  "line-spacing": 1.15,
+  margins: 1,
+  "page-size": "letter",
+  "page-numbers": true,
+  sections: 5,
+  style: "professional",
+  tone: "neutral",
+  length: "medium",
+  toc: false,
+};
+
+function normalizeFlag(flag: string): string {
+  return ALIASES[flag] ?? flag;
+}
+
+function parseBoolean(value: string | undefined): boolean {
+  if (value === undefined) return true;
+  if (/^(false|0|no)$/i.test(value)) return false;
+  if (/^(true|1|yes)$/i.test(value)) return true;
+  return Boolean(value);
+}
+
+function parseArgs(argv: string[]): ParsedArgs {
+  const args: ParsedArgs = { ...DEFAULT_ARGS, _: [] };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+
+    if (token === "--") {
+      args._.push(...argv.slice(index + 1));
+      break;
+    }
+
+    if (token.startsWith("--no-")) {
+      args[normalizeFlag(token.slice(5))] = false;
+      continue;
+    }
+
+    if (token.startsWith("--")) {
+      const [rawFlag, inlineValue] = token.slice(2).split(/=(.*)/s, 2);
+      const flag = normalizeFlag(rawFlag);
+
+      if (BOOLEAN_FLAGS.has(flag)) {
+        args[flag] = parseBoolean(inlineValue);
+        continue;
+      }
+
+      if (inlineValue !== undefined) {
+        args[flag] = inlineValue;
+        continue;
+      }
+
+      const next = argv[index + 1];
+      if (next !== undefined && !next.startsWith("-")) {
+        args[flag] = next;
+        index += 1;
+      } else {
+        args[flag] = "";
+      }
+      continue;
+    }
+
+    if (token.startsWith("-") && token !== "-") {
+      const shortFlags = token.slice(1);
+      const firstFlag = normalizeFlag(shortFlags[0]);
+
+      if (shortFlags.length === 1 && !BOOLEAN_FLAGS.has(firstFlag)) {
+        const next = argv[index + 1];
+        args[firstFlag] = next ?? "";
+        if (next !== undefined) index += 1;
+        continue;
+      }
+
+      for (const shortFlag of shortFlags) {
+        args[normalizeFlag(shortFlag)] = true;
+      }
+      continue;
+    }
+
+    args._.push(token);
+  }
+
+  return args;
+}
+
+function stringArg(args: ParsedArgs, name: string, fallback = ""): string {
+  const value = args[name];
+  if (value === undefined || value === false) return fallback;
+  return String(value);
+}
+
+function numberArg(args: ParsedArgs, name: string, fallback: number): number {
+  const value = Number(args[name]);
+  return Number.isFinite(value) ? value : fallback;
+}
+
+export function parseCli(argv = process.argv.slice(2)): CliResult {
+  const args = parseArgs(argv);
+
+  if (args.help) {
+    console.log(HELP);
+    process.exit(0);
+  }
+
+  const options: DocOptions = {
+    output: stringArg(args, "output"),
+    dir: stringArg(args, "dir", ".skills/exports"),
+    template: stringArg(args, "template", "default") as DocOptions["template"],
+    title: stringArg(args, "title"),
+    author: stringArg(args, "author"),
+    company: stringArg(args, "company"),
+    date: stringArg(args, "date", new Date().toLocaleDateString()),
+    font: stringArg(args, "font", "Calibri"),
+    fontSize: numberArg(args, "font-size", 11),
+    headingFont: stringArg(args, "heading-font", "Calibri Light"),
+    lineSpacing: numberArg(args, "line-spacing", 1.15),
+    margins: numberArg(args, "margins", 1),
+    pageSize: stringArg(args, "page-size", "letter") as DocOptions["pageSize"],
+    toc: Boolean(args.toc),
+    pageNumbers: Boolean(args["page-numbers"]),
+    header: stringArg(args, "header"),
+    footer: stringArg(args, "footer"),
+    topic: stringArg(args, "topic") || null,
+    prompt: stringArg(args, "prompt") || null,
+    text: stringArg(args, "text") || null,
+    sections: numberArg(args, "sections", 5),
+    style: stringArg(args, "style", "professional") as DocOptions["style"],
+    tone: stringArg(args, "tone", "neutral") as DocOptions["tone"],
+    length: stringArg(args, "length", "medium") as DocOptions["length"],
+  };
+
+  return {
+    options,
+    inputFile: args._[0] as string | undefined,
+  };
+}

package/skills/doc-generate/src/dependencies.ts

@@ -0,0 +1,44 @@
+import type { DocumentDeps } from "./types";
+
+let loadedDeps: DocumentDeps | null = null;
+
+export async function loadDocumentDeps(): Promise<DocumentDeps> {
+  if (loadedDeps) return loadedDeps;
+
+  try {
+    const docx = await import("docx");
+    const { marked } = await import("marked");
+    loadedDeps = {
+      Document: docx.Document,
+      Packer: docx.Packer,
+      Paragraph: docx.Paragraph,
+      TextRun: docx.TextRun,
+      HeadingLevel: docx.HeadingLevel,
+      Table: docx.Table,
+      TableRow: docx.TableRow,
+      TableCell: docx.TableCell,
+      WidthType: docx.WidthType,
+      AlignmentType: docx.AlignmentType,
+      BorderStyle: docx.BorderStyle,
+      PageNumber: docx.PageNumber,
+      NumberFormat: docx.NumberFormat,
+      Header: docx.Header,
+      Footer: docx.Footer,
+      TableOfContents: docx.TableOfContents,
+      PageBreak: docx.PageBreak,
+      marked,
+    };
+    return loadedDeps;
+  } catch {
+    throw new Error("Missing document generation dependencies. Run bun install in this skill directory.");
+  }
+}
+
+export async function createOpenAIClient(apiKey: string) {
+  try {
+    const { default: OpenAI } = await import("openai");
+    return new OpenAI({ apiKey });
+  } catch {
+    throw new Error("Missing dependency 'openai'. Run bun install in this skill directory.");
+  }
+}