@hasna/skills 0.1.61 → 0.1.63

package/skills/pdf-generate/SKILL.md

@@ -1,86 +0,0 @@
----
-name: pdf-generate
-version: 0.1.0
-description: Generate high-quality PDF documents from markdown, HTML, or templates
-category: Productivity
-tags:
-  - pdf
-  - document
-  - generation
-  - reports
-  - invoices
-  - contracts
-  - conversion
-  - automation
-author: Hasna
-license: MIT
-compatibility:
-  - claude-code
-  - openai-codex
----
-
-# Generate PDF
-
-Turn anything into a PDF. Convert Markdown, HTML, or plain text into polished PDF documents. Includes templates for reports, contracts, and resumes with custom headers and footers. Perfect for generating official docs on the fly.
-
-## Features
-
-- **Format Conversion**: Turns Markdown/HTML into professional PDFs.
-- **Templates**: Built-in layouts for Invoices, Reports, Resumes, and Letters.
-- **Web Capture**: Converts any URL into a PDF document.
-- **Customization**: Supports custom CSS, margins, page sizes (A4, Letter), and orientation.
-- **Headers/Footers**: Adds page numbers, dates, and titles automatically.
-
-> **This is a CLI skill.** It requires the `skills` CLI to execute. Install it with `npm install -g @hasna/skills`, then run the commands below.
-
-## Usage
-
-```bash
-# Convert markdown file
-skills run generate-pdf -- --file report.md --format A4
-
-# Generate from template
-skills run generate-pdf/template -- \
-  --template invoice \
-  --data '{"companyName":"Acme","total":"$1000"}'
-
-# Capture a webpage
-skills run generate-pdf/fromUrl -- --url https://example.com
-```
-
-## Options
-
-| Option       | Description                                      | Default   |
-| ------------ | ------------------------------------------------ | --------- |
-| `--file`     | Input file path                                  | -         |
-| `--content`  | Inline content string                            | -         |
-| `--format`   | Page size (`A4`, `Letter`, `Legal`)              | A4        |
-| `--template` | Use a preset (`invoice`, `report`, `resume`)     | -         |
-| `--url`      | Webpage URL to capture                           | -         |
-| `--output`   | Custom output filename                           | (auto)    |
-
-## Output
-
-- **PDF File**: The generated document.
-- **Metadata**: Details about the generation process.
-
-## Examples
-
-### Contract Generation
-```bash
-skills run generate-pdf/template -- \
-  --template contract \
-  --data '{"party1":"Alice", "party2":"Bob", "date":"2025-10-01"}' \
-  --filename contract_signed.pdf
-```
-
-### Documentation Build
-```bash
-skills run generate-pdf -- --file README.md \
-  --css "body { font-family: Helvetica; }" \
-  --header "Project Documentation"
-```
-
-## Requirements
-
-- Bun runtime.

package/skills/pdf-generate/package.json

@@ -1,21 +0,0 @@
-{
-  "name": "pdf-generate",
-  "version": "0.1.0",
-  "description": "Generate PDF documents with rich formatting and layouts",
-  "type": "module",
-  "bin": {
-    "pdf-generate": "./src/index.ts"
-  },
-  "scripts": {
-    "start": "bun run src/index.ts",
-    "dev": "bun run --watch src/index.ts",
-    "cli": "bun run src/index.ts"
-  },
-  "dependencies": {
-    "pdf-lib": "^1.17.1"
-  },
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org",
-    "access": "restricted"
-  }
-}

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

@@ -1,162 +0,0 @@
-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

@@ -1,84 +0,0 @@
-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");
-}

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

@@ -1,62 +0,0 @@
-#!/usr/bin/env bun
-
-import { writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { parseArgs } from "./cli";
-import { generateHtml } from "./html";
-import { writePdfDocument } from "./pdf-writer";
-import { EXPORTS_DIR, SESSION_ID, SKILL_NAME, log } from "./runtime";
-
-async function main() {
-  try {
-    log(`Starting ${SKILL_NAME} skill (Session: ${SESSION_ID})`);
-    log(`Arguments: ${Bun.argv.slice(2).join(" ")}`);
-
-    const options = parseArgs(Bun.argv.slice(2));
-
-    if (!options.content && !options.template && !options.url) {
-      console.error("Error: No content provided. Use --content, --file, --template, or --url");
-      process.exit(1);
-    }
-
-    const html = generateHtml(options);
-    log(`Generated HTML (${html.length} characters)`);
-
-    const filename = options.filename
-      ? `${options.filename}.pdf`
-      : `document_${SESSION_ID}.pdf`;
-
-    const htmlFile = join(EXPORTS_DIR, filename.replace(".pdf", ".html"));
-    writeFileSync(htmlFile, html);
-    log(`Saved HTML to: ${htmlFile}`);
-
-    const pdfFile = join(EXPORTS_DIR, filename);
-    await writePdfDocument(html, options, pdfFile);
-    log(`Saved PDF to: ${pdfFile}`);
-
-    console.log(JSON.stringify({
-      success: true,
-      message: "PDF document generated successfully",
-      data: {
-        pdfFile,
-        htmlFile,
-        filename,
-        format: options.format,
-        orientation: options.orientation,
-        contentLength: html.length,
-        template: options.template || null,
-      },
-    }, null, 2));
-    log(`Successfully generated document: ${filename}`);
-  } catch (error) {
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    log(`Error: ${errorMessage}`, "error");
-    console.error(JSON.stringify({
-      success: false,
-      error: `Error generating PDF: ${errorMessage}`,
-    }));
-    process.exit(1);
-  }
-}
-
-main();

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

@@ -1,27 +0,0 @@
-import { escapeHtml, sanitizeUrl } from "./security";
-
-export function markdownToHtml(markdown: string): string {
-  let html = markdown
-    .replace(/^### (.*$)/gim, "<h3>$1</h3>")
-    .replace(/^## (.*$)/gim, "<h2>$1</h2>")
-    .replace(/^# (.*$)/gim, "<h1>$1</h1>")
-    .replace(/\*\*(.+?)\*\*/g, "<strong>$1</strong>")
-    .replace(/__(.+?)__/g, "<strong>$1</strong>")
-    .replace(/\*(.+?)\*/g, "<em>$1</em>")
-    .replace(/_(.+?)_/g, "<em>$1</em>")
-    .replace(/```(\w*)\n([\s\S]*?)```/g, '<pre><code class="language-$1">$2</code></pre>')
-    .replace(/`(.+?)`/g, "<code>$1</code>")
-    .replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_, text, url) => {
-      const safeUrl = sanitizeUrl(url);
-      const safeText = escapeHtml(text);
-      return safeUrl ? `<a href="${safeUrl}">${safeText}</a>` : safeText;
-    })
-    .replace(/^\s*[-*]\s+(.*)$/gim, "<li>$1</li>")
-    .replace(/^\s*\d+\.\s+(.*)$/gim, "<li>$1</li>")
-    .replace(/^---$/gim, "<hr>")
-    .replace(/\n\n/g, "</p><p>")
-    .replace(/\n/g, "<br>");
-
-  html = html.replace(/(<li>.*?<\/li>)+/gs, "<ul>$&</ul>");
-  return `<p>${html}</p>`;
-}

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

@@ -1,78 +0,0 @@
-import { writeFileSync } from "node:fs";
-import { htmlToPlainText } from "./html";
-import { loadPdfLib } from "./runtime";
-import { PAGE_FORMATS, type GenerateOptions } from "./types";
-
-function pageSizeToPoints(format: string, orientation: "portrait" | "landscape"): [number, number] {
-  const size = PAGE_FORMATS[format] ?? PAGE_FORMATS.A4;
-  const width = (size.width / 25.4) * 72;
-  const height = (size.height / 25.4) * 72;
-  return orientation === "landscape" ? [height, width] : [width, height];
-}
-
-function wrapText(text: string, maxCharacters: number): string[] {
-  const lines: string[] = [];
-  for (const paragraph of text.split("\n")) {
-    let current = "";
-    for (const word of paragraph.split(/\s+/).filter(Boolean)) {
-      const candidate = current ? `${current} ${word}` : word;
-      if (candidate.length > maxCharacters && current) {
-        lines.push(current);
-        current = word;
-      } else {
-        current = candidate;
-      }
-    }
-    if (current) lines.push(current);
-    lines.push("");
-  }
-  return lines;
-}
-
-export async function writePdfDocument(html: string, options: GenerateOptions, outputPath: string): Promise<void> {
-  const { PDFDocument, StandardFonts, rgb } = await loadPdfLib();
-  const pdfDoc = await PDFDocument.create();
-  const font = await pdfDoc.embedFont(StandardFonts.Helvetica);
-  const boldFont = await pdfDoc.embedFont(StandardFonts.HelveticaBold);
-  const [width, height] = pageSizeToPoints(options.format, options.orientation);
-  const margin = 54;
-  const fontSize = 11;
-  const lineHeight = 16;
-  const maxCharacters = Math.max(40, Math.floor((width - margin * 2) / (fontSize * 0.52)));
-  const lines = wrapText(htmlToPlainText(html), maxCharacters);
-
-  let page = pdfDoc.addPage([width, height]);
-  let y = height - margin;
-
-  if (options.title) {
-    page.drawText(options.title, {
-      x: margin,
-      y,
-      size: 18,
-      font: boldFont,
-      color: rgb(0.12, 0.18, 0.26),
-    });
-    y -= lineHeight * 2;
-  }
-
-  for (const line of lines) {
-    if (y < margin) {
-      page = pdfDoc.addPage([width, height]);
-      y = height - margin;
-    }
-
-    if (line) {
-      page.drawText(line, {
-        x: margin,
-        y,
-        size: fontSize,
-        font,
-        color: rgb(0.1, 0.1, 0.1),
-      });
-    }
-    y -= lineHeight;
-  }
-
-  const bytes = await pdfDoc.save();
-  writeFileSync(outputPath, bytes);
-}

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

@@ -1,34 +0,0 @@
-import { appendFileSync, existsSync, mkdirSync } from "node:fs";
-import { join } from "node:path";
-
-export type PdfLibModule = typeof import("pdf-lib");
-
-export const SKILL_NAME = "generate-pdf";
-export const SESSION_ID = `${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
-export const EXPORTS_DIR = process.env.SKILLS_EXPORTS_DIR || join(process.cwd(), "exports");
-export const LOGS_DIR = process.env.SKILLS_LOGS_DIR || join(process.cwd(), "logs");
-export const SKILLS_INPUT = process.env.SKILLS_INPUT || "";
-export const LOG_FILE = join(LOGS_DIR, `${SESSION_ID}.log`);
-
-[EXPORTS_DIR, LOGS_DIR].forEach((dir) => {
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
-});
-
-export function log(message: string, level: "info" | "error" | "warn" = "info") {
-  const timestamp = new Date().toISOString();
-  const logMessage = `[${timestamp}] [${level.toUpperCase()}] ${message}\n`;
-  appendFileSync(LOG_FILE, logMessage);
-  if (level === "error") {
-    console.error(message);
-  }
-}
-
-export async function loadPdfLib(): Promise<PdfLibModule> {
-  try {
-    return await import("pdf-lib");
-  } catch {
-    throw new Error("Missing dependency 'pdf-lib'. Run bun install in this skill directory.");
-  }
-}

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

@@ -1,37 +0,0 @@
-export function escapeHtml(str: string | undefined | null): string {
-  if (str === undefined || str === null) return "";
-  return String(str)
-    .replace(/&/g, "&")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;")
-    .replace(/"/g, "&quot;")
-    .replace(/'/g, "&#x27;");
-}
-
-export function sanitizeUrl(url: string | undefined | null): string {
-  if (!url) return "";
-  const trimmed = url.trim();
-  const lowerUrl = trimmed.toLowerCase();
-  if (lowerUrl.startsWith("javascript:") || lowerUrl.startsWith("data:") || lowerUrl.startsWith("vbscript:")) {
-    return "";
-  }
-  return escapeHtml(trimmed);
-}
-
-export function sanitizeTemplateData(data: Record<string, string>): Record<string, string> {
-  const sanitized: Record<string, string> = {};
-  for (const [key, value] of Object.entries(data)) {
-    const lowerKey = key.toLowerCase();
-    if (
-      lowerKey.includes("linkedin") ||
-      lowerKey.includes("website") ||
-      lowerKey.includes("url") ||
-      lowerKey.includes("href")
-    ) {
-      sanitized[key] = sanitizeUrl(value);
-    } else {
-      sanitized[key] = escapeHtml(value);
-    }
-  }
-  return sanitized;
-}