@hasna/skills 0.1.27 → 0.1.30

package/skills/npmpublish/src/index.ts

@@ -1,10 +1,9 @@
 #!/usr/bin/env bun
 
 import { program } from "commander";
-import { readFile, writeFile, mkdir } from "fs/promises";
+import { readFile, writeFile } from "fs/promises";
 import { join } from "path";
 import { execSync } from "child_process";
-import { homedir } from "os";
 import chalk from "chalk";
 import ora from "ora";
 import semver from "semver";
@@ -20,7 +19,6 @@ interface PackageJson {
 }
 
 type BumpType = "patch" | "minor" | "major";
-type Platform = "claude" | "codex";
 
 // ============================================================================
 // Publish Command
@@ -146,131 +144,6 @@ async function publish(options: {
   }
 }
 
-// ============================================================================
-// Install Command
-// ============================================================================
-
-const SKILL_MD_CONTENT = `---
-name: npmpublish
-description: Publish npm packages with sensible defaults. Automatically sets private access and bumps patch version (0.0.1). Use when publishing packages to npm, especially for internal/private packages.
----
-
-# npm Publish
-
-Publish npm packages to the npm registry with sensible defaults:
-- **Private by default** - Sets \`publishConfig.access: restricted\`
-- **Patch bump by default** - Increments version by 0.0.1
-
-## CLI Usage
-
-Run the CLI directly:
-
-\`\`\`bash
-# Publish with defaults (private, patch bump)
-npmpublish
-
-# Specify bump type
-npmpublish --bump minor    # 0.1.0
-npmpublish --bump major    # 1.0.0
-npmpublish --bump patch    # 0.0.1 (default)
-
-# Publish as public (use carefully!)
-npmpublish --public
-
-# Dry run (see what would happen)
-npmpublish --dry-run
-
-# Publish from a different directory
-npmpublish --dir /path/to/package
-\`\`\`
-
-## Options
-
-| Option | Description | Default |
-|--------|-------------|---------|
-| \`-b, --bump <type>\` | Version bump: patch, minor, major | patch |
-| \`--public\` | Publish as public package | false (private) |
-| \`--dry-run\` | Preview without publishing | false |
-| \`-d, --dir <path>\` | Package directory | current dir |
-
-## Data Directories
-
-- **exports/** - Published package logs
-- **uploads/** - Files to include in publish
-- **logs/** - Execution logs
-
-## Requirements
-
-- \`NPM_TOKEN\` in \`~/.secrets\` for authentication
-- Valid \`package.json\` in target directory
-- Bun runtime with \`npmpublish\` installed globally
-
-## Install CLI
-
-\`\`\`bash
-bun add -g @hasnaxyz/npmpublish
-\`\`\`
-`;
-
-async function ensureDir(dir: string): Promise<void> {
-  await mkdir(dir, { recursive: true });
-}
-
-function getSkillsDir(platform: Platform, local: boolean): string {
-  if (local) {
-    return platform === "claude" ? ".claude/skills" : ".codex/skills";
-  }
-  const home = homedir();
-  return platform === "claude"
-    ? join(home, ".claude", "skills")
-    : join(home, ".codex", "skills");
-}
-
-async function installSkill(options: {
-  platform: Platform;
-  local: boolean;
-}): Promise<void> {
-  const spinner = ora();
-  const skillName = "npmpublish";
-  const baseDir = getSkillsDir(options.platform, options.local);
-  const skillDir = join(baseDir, skillName);
-
-  try {
-    spinner.start(`Installing skill to ${options.platform === "claude" ? "Claude Code" : "Codex"}...`);
-
-    // Create skill directory structure
-    await ensureDir(skillDir);
-    await ensureDir(join(skillDir, "exports"));
-    await ensureDir(join(skillDir, "uploads"));
-    await ensureDir(join(skillDir, "logs"));
-
-    // Write SKILL.md
-    const skillMdPath = join(skillDir, "SKILL.md");
-    await writeFile(skillMdPath, SKILL_MD_CONTENT, "utf-8");
-
-    spinner.succeed(`Installed to ${chalk.cyan(skillDir)}`);
-
-    console.log();
-    console.log(chalk.green("✓"), `Skill ${chalk.cyan(skillName)} installed successfully`);
-    console.log();
-    console.log("Created structure:");
-    console.log(chalk.dim(`  ${skillDir}/`));
-    console.log(chalk.dim(`  ├── SKILL.md`));
-    console.log(chalk.dim(`  ├── exports/`));
-    console.log(chalk.dim(`  ├── uploads/`));
-    console.log(chalk.dim(`  └── logs/`));
-    console.log();
-    console.log(`Invoke with: ${chalk.cyan(`/${skillName}`)}`);
-
-  } catch (error) {
-    spinner.fail("Install failed");
-    if (error instanceof Error) {
-      console.error(chalk.red(error.message));
-    }
-    process.exit(1);
-  }
-}
-
 // ============================================================================
 // CLI Setup
 // ============================================================================
@@ -305,26 +178,15 @@ program
 // Install subcommand
 program
   .command("install")
-  .description("Install this skill to Claude Code or Codex")
-  .option("--claude", "Install to Claude Code (~/.claude/skills/)")
-  .option("--codex", "Install to OpenAI Codex (~/.codex/skills/)")
-  .option("--local", "Install to local repo (.claude/skills/ or .codex/skills/)")
+  .description("Disabled: register the root Skills MCP server instead")
+  .option("--claude", "Show Claude Code MCP registration guidance")
+  .option("--codex", "Show Codex MCP registration guidance")
+  .option("--local", "Ignored; per-skill local folders are disabled")
   .action(async (options) => {
-    if (!options.claude && !options.codex) {
-      console.error(chalk.red("Please specify --claude or --codex"));
-      process.exit(1);
-    }
-
-    const platforms: Platform[] = [];
-    if (options.claude) platforms.push("claude");
-    if (options.codex) platforms.push("codex");
-
-    for (const platform of platforms) {
-      await installSkill({
-        platform,
-        local: options.local || false,
-      });
-    }
+    const target = options.claude ? "claude" : options.codex ? "codex" : "all";
+    console.error(chalk.red("Direct per-skill installs are disabled."));
+    console.error(`Use: skills mcp --register ${target}`);
+    process.exit(1);
   });
 
 program.parse();

package/skills/one-page-website/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: one-page-website
+description: Generate premium static one-page website bundles with HTML, CSS, JavaScript, copy, section map, deploy notes, and manifest.
+---
+
+# One Page Website
+
+Generate a complete static one-page website bundle for a SaaS product, service, launch, waitlist, portfolio offer, or internal tool.
+
+## 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 one-page-website "Usage-based billing for AI SaaS" --name "MeterKit" --audience "founders"
+skills run one-page-website --brief "Customer feedback analytics" --goal "join the waitlist" --style "sharp and editorial"
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--brief <text>` | Product, service, or website brief. Positional text also works. | required |
+| `--name <text>` | Brand or page name. | derived from brief |
+| `--audience <text>` | Target visitor. | software teams |
+| `--goal <text>` | Primary conversion goal. | book a demo |
+| `--style <text>` | Visual and voice direction. | polished SaaS, crisp UI, confident copy |
+| `--proof <text>` | Proof points or trust signals. | customer outcomes and workflow proof |
+| `--sections <list>` | Comma-separated sections. | hero,features,proof,pricing,faq,cta |
+| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+
+## Outputs
+
+- `site/index.html`
+- `site/styles.css`
+- `site/script.js`
+- `site/README.md`
+- `copy.md`
+- `section-map.json`
+- `deploy-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/one-page-website/package.json

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

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

@@ -0,0 +1,8 @@
+{
+  "extends": "../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"]
+}

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

@@ -0,0 +1,162 @@
+import { existsSync, readFileSync } from "node:fs";
+import { log, SKILLS_INPUT } from "./runtime";
+import { templates } from "./templates";
+import { PAGE_FORMATS, type GenerateOptions } from "./types";
+
+export function parseArgs(args: string[]): GenerateOptions {
+  const options: GenerateOptions = {
+    contentType: "markdown",
+    format: "A4",
+    orientation: "portrait",
+    margin: { top: "1cm", right: "1cm", bottom: "1cm", left: "1cm" },
+    displayHeaderFooter: false,
+    printBackground: true,
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    const nextArg = args[i + 1];
+
+    switch (arg) {
+      case "-h":
+      case "--help":
+        console.log(`
+pdf-generate - Generate high-quality PDF documents
+
+Usage:
+  skills run generate-pdf -- [options]
+
+Options:
+  -h, --help               Show this help message
+  --content <text>         Content to convert (markdown, HTML, or text)
+  --content-type <type>    Content type: markdown | html | text (default: markdown)
+  --file <path>            Read content from file
+  --template <name>        Use built-in template: invoice | report | resume | letter | contract
+  --data <json>            JSON data for template variables
+  --url <url>              Generate PDF from URL
+  --format <size>          Page format: A4 | Letter | Legal | A3 | A5 | Tabloid (default: A4)
+  --orientation <type>     Page orientation: portrait | landscape (default: portrait)
+  --title <text>           Document title
+  --author <text>          Document author
+  --filename <name>        Output filename (without extension)
+  --css <styles>           Custom CSS styles
+  --header <html>          Header HTML
+  --footer <html>          Footer HTML
+
+Templates:
+  invoice                  Professional invoice template
+  report                   Business report template
+  resume                   Resume/CV template
+  letter                   Formal letter template
+  contract                 Contract/agreement template
+
+Examples:
+  # Generate PDF from markdown
+  skills run generate-pdf -- --content "# Hello World" --filename report
+
+  # Use a template with data
+  skills run generate-pdf -- --template invoice --data '{"clientName":"Acme Corp","total":"$1000"}'
+
+  # Convert a file
+  skills run generate-pdf -- --file ./README.md --format Letter
+`);
+        process.exit(0);
+      case "--content":
+        if (nextArg) {
+          options.content = nextArg;
+          i++;
+        }
+        break;
+      case "--content-type":
+        if (nextArg && ["markdown", "html", "text"].includes(nextArg)) {
+          options.contentType = nextArg as "markdown" | "html" | "text";
+          i++;
+        }
+        break;
+      case "--format":
+        if (nextArg && PAGE_FORMATS[nextArg]) {
+          options.format = nextArg;
+          i++;
+        }
+        break;
+      case "--orientation":
+        if (nextArg && ["portrait", "landscape"].includes(nextArg)) {
+          options.orientation = nextArg as "portrait" | "landscape";
+          i++;
+        }
+        break;
+      case "--title":
+        if (nextArg) {
+          options.title = nextArg;
+          i++;
+        }
+        break;
+      case "--author":
+        if (nextArg) {
+          options.author = nextArg;
+          i++;
+        }
+        break;
+      case "--filename":
+        if (nextArg) {
+          options.filename = nextArg;
+          i++;
+        }
+        break;
+      case "--template":
+        if (nextArg && templates[nextArg]) {
+          options.template = nextArg;
+          i++;
+        }
+        break;
+      case "--data":
+        if (nextArg) {
+          try {
+            options.data = JSON.parse(nextArg);
+          } catch {
+            log(`Invalid JSON data: ${nextArg}`, "warn");
+          }
+          i++;
+        }
+        break;
+      case "--url":
+        if (nextArg) {
+          options.url = nextArg;
+          i++;
+        }
+        break;
+      case "--file":
+        if (nextArg && existsSync(nextArg)) {
+          options.content = readFileSync(nextArg, "utf-8");
+          i++;
+        }
+        break;
+      case "--css":
+        if (nextArg) {
+          options.css = nextArg;
+          i++;
+        }
+        break;
+      case "--header":
+        if (nextArg) {
+          options.header = nextArg;
+          options.displayHeaderFooter = true;
+          i++;
+        }
+        break;
+      case "--footer":
+        if (nextArg) {
+          options.footer = nextArg;
+          options.displayHeaderFooter = true;
+          i++;
+        }
+        break;
+    }
+  }
+
+  if (!options.content && !options.template && !options.url && SKILLS_INPUT) {
+    options.content = SKILLS_INPUT;
+  }
+
+  return options;
+}

package/skills/pdf-generate/src/html.ts

@@ -0,0 +1,84 @@
+import { markdownToHtml } from "./markdown";
+import { escapeHtml, sanitizeTemplateData } from "./security";
+import { templates } from "./templates";
+import type { GenerateOptions } from "./types";
+
+export function generateHtml(options: GenerateOptions): string {
+  let bodyContent = "";
+
+  if (options.template && options.data) {
+    const templateFn = templates[options.template];
+    if (templateFn) {
+      const sanitizedData = sanitizeTemplateData(options.data);
+      return templateFn(sanitizedData);
+    }
+  }
+
+  if (options.content) {
+    switch (options.contentType) {
+      case "markdown":
+        bodyContent = markdownToHtml(options.content);
+        break;
+      case "html":
+        bodyContent = options.content;
+        break;
+      case "text":
+        bodyContent = `<pre style="white-space: pre-wrap; font-family: monospace;">${escapeHtml(options.content)}</pre>`;
+        break;
+    }
+  }
+
+  return `
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <title>${escapeHtml(options.title) || "Document"}</title>
+  <style>
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      line-height: 1.6;
+      color: #333;
+      max-width: 100%;
+      padding: 20px;
+    }
+    h1, h2, h3 { color: #2c3e50; margin-top: 1.5em; }
+    h1 { font-size: 2em; border-bottom: 2px solid #3498db; padding-bottom: 0.3em; }
+    h2 { font-size: 1.5em; border-bottom: 1px solid #ddd; padding-bottom: 0.2em; }
+    code { background: #f4f4f4; padding: 2px 6px; border-radius: 3px; font-size: 0.9em; }
+    pre { background: #f8f8f8; padding: 15px; border-radius: 5px; overflow-x: auto; }
+    pre code { background: none; padding: 0; }
+    a { color: #3498db; }
+    table { border-collapse: collapse; width: 100%; margin: 1em 0; }
+    th, td { border: 1px solid #ddd; padding: 8px; text-align: left; }
+    th { background: #f4f4f4; }
+    blockquote { border-left: 4px solid #3498db; margin: 1em 0; padding-left: 1em; color: #666; }
+    ul, ol { padding-left: 2em; }
+    hr { border: none; border-top: 1px solid #ddd; margin: 2em 0; }
+    ${options.css || ""}
+  </style>
+</head>
+<body>
+  ${bodyContent}
+</body>
+</html>`;
+}
+
+export function htmlToPlainText(html: string): string {
+  return html
+    .replace(/<style[\s\S]*?<\/style>/gi, "")
+    .replace(/<script[\s\S]*?<\/script>/gi, "")
+    .replace(/<\/(h1|h2|h3|p|div|li|tr)>/gi, "\n")
+    .replace(/<br\s*\/?>/gi, "\n")
+    .replace(/<[^>]+>/g, "")
+    .replace(/&nbsp;/g, " ")
+    .replace(/&amp;/g, "&")
+    .replace(/&lt;/g, "<")
+    .replace(/&gt;/g, ">")
+    .replace(/&quot;/g, '"')
+    .replace(/&#x27;/g, "'")
+    .split("\n")
+    .map((line) => line.trim())
+    .filter(Boolean)
+    .join("\n");
+}