@hasna/skills 0.1.27 → 0.1.30

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

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

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

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

@@ -0,0 +1,37 @@
+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;
+}

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

@@ -0,0 +1,311 @@
+// Invoice template
+export const templates: Record<string, (data: Record<string, string>) => string> = {
+  invoice: (data) => `
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <style>
+    body { font-family: Arial, sans-serif; margin: 40px; color: #333; }
+    .header { display: flex; justify-content: space-between; margin-bottom: 40px; }
+    .company-info { font-size: 14px; }
+    .invoice-info { text-align: right; }
+    .invoice-title { font-size: 28px; color: #2c3e50; margin-bottom: 10px; }
+    .invoice-number { font-size: 14px; color: #7f8c8d; }
+    .addresses { display: flex; justify-content: space-between; margin-bottom: 40px; }
+    .address-block { width: 45%; }
+    .address-label { font-weight: bold; color: #2c3e50; margin-bottom: 10px; }
+    table { width: 100%; border-collapse: collapse; margin-bottom: 30px; }
+    th { background: #2c3e50; color: white; padding: 12px; text-align: left; }
+    td { padding: 12px; border-bottom: 1px solid #ddd; }
+    .totals { text-align: right; }
+    .totals table { width: 300px; margin-left: auto; }
+    .totals td { border: none; padding: 8px; }
+    .total-row { font-weight: bold; font-size: 18px; background: #f8f9fa; }
+    .notes { margin-top: 40px; padding: 20px; background: #f8f9fa; border-radius: 4px; }
+    .footer { margin-top: 40px; text-align: center; font-size: 12px; color: #7f8c8d; }
+  </style>
+</head>
+<body>
+  <div class="header">
+    <div class="company-info">
+      <h2>${data.companyName || 'Company Name'}</h2>
+      <p>${data.companyAddress || ''}<br>
+      ${data.companyCity || ''}, ${data.companyState || ''} ${data.companyZip || ''}<br>
+      ${data.companyPhone || ''}</p>
+    </div>
+    <div class="invoice-info">
+      <div class="invoice-title">INVOICE</div>
+      <div class="invoice-number">#${data.invoiceNumber || 'INV-001'}</div>
+      <p>Date: ${data.invoiceDate || new Date().toLocaleDateString()}<br>
+      Due: ${data.dueDate || ''}</p>
+    </div>
+  </div>
+
+  <div class="addresses">
+    <div class="address-block">
+      <div class="address-label">Bill To:</div>
+      <p>${data.clientName || 'Client Name'}<br>
+      ${data.clientAddress || ''}<br>
+      ${data.clientCity || ''}, ${data.clientState || ''} ${data.clientZip || ''}</p>
+    </div>
+    <div class="address-block">
+      <div class="address-label">Payment Details:</div>
+      <p>Terms: ${data.paymentTerms || 'Net 30'}<br>
+      Method: ${data.paymentMethod || 'Bank Transfer'}</p>
+    </div>
+  </div>
+
+  <table>
+    <thead>
+      <tr>
+        <th>Description</th>
+        <th>Qty</th>
+        <th>Rate</th>
+        <th>Amount</th>
+      </tr>
+    </thead>
+    <tbody>
+      ${data.items || '<tr><td>Service</td><td>1</td><td>$0</td><td>$0</td></tr>'}
+    </tbody>
+  </table>
+
+  <div class="totals">
+    <table>
+      <tr><td>Subtotal:</td><td>${data.subtotal || '$0'}</td></tr>
+      <tr><td>Tax (${data.taxRate || '0'}%):</td><td>${data.tax || '$0'}</td></tr>
+      <tr class="total-row"><td>Total:</td><td>${data.total || '$0'}</td></tr>
+    </table>
+  </div>
+
+  ${data.notes ? `<div class="notes"><strong>Notes:</strong><br>${data.notes}</div>` : ''}
+
+  <div class="footer">Thank you for your business!</div>
+</body>
+</html>`,
+
+  report: (data) => `
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <style>
+    body { font-family: Georgia, serif; margin: 40px; color: #333; line-height: 1.6; }
+    .title-page { text-align: center; margin-bottom: 60px; padding-top: 100px; }
+    .title { font-size: 36px; color: #2c3e50; margin-bottom: 10px; }
+    .subtitle { font-size: 20px; color: #7f8c8d; margin-bottom: 40px; }
+    .meta { font-size: 14px; color: #95a5a6; }
+    h2 { color: #2c3e50; border-bottom: 2px solid #3498db; padding-bottom: 10px; margin-top: 40px; }
+    .executive-summary { background: #f8f9fa; padding: 20px; border-left: 4px solid #3498db; margin: 30px 0; }
+    .section { margin-bottom: 30px; }
+    .conclusion { background: #e8f4f8; padding: 20px; border-radius: 4px; margin-top: 40px; }
+    .footer { margin-top: 60px; text-align: center; font-size: 12px; color: #7f8c8d; border-top: 1px solid #ddd; padding-top: 20px; }
+  </style>
+</head>
+<body>
+  <div class="title-page">
+    <div class="title">${data.title || 'Report Title'}</div>
+    <div class="subtitle">${data.subtitle || ''}</div>
+    <div class="meta">
+      <p>Date: ${data.reportDate || new Date().toLocaleDateString()}</p>
+      <p>Author: ${data.author || ''}</p>
+    </div>
+  </div>
+
+  <div class="executive-summary">
+    <h2>Executive Summary</h2>
+    <p>${data.executiveSummary || ''}</p>
+  </div>
+
+  <div class="section">
+    <h2>${data.section1Title || 'Introduction'}</h2>
+    <p>${data.section1Content || ''}</p>
+  </div>
+
+  <div class="section">
+    <h2>${data.section2Title || 'Analysis'}</h2>
+    <p>${data.section2Content || ''}</p>
+  </div>
+
+  <div class="conclusion">
+    <h2>Conclusion</h2>
+    <p>${data.conclusion || ''}</p>
+  </div>
+
+  <div class="footer">
+    <p>${data.companyName || ''} | ${data.companyContact || ''}</p>
+  </div>
+</body>
+</html>`,
+
+  resume: (data) => `
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <style>
+    body { font-family: 'Helvetica Neue', Arial, sans-serif; margin: 40px; color: #333; line-height: 1.5; }
+    .header { text-align: center; margin-bottom: 30px; border-bottom: 2px solid #2c3e50; padding-bottom: 20px; }
+    .name { font-size: 32px; color: #2c3e50; margin-bottom: 10px; }
+    .contact { font-size: 14px; color: #7f8c8d; }
+    .contact a { color: #3498db; text-decoration: none; }
+    h2 { color: #2c3e50; font-size: 16px; text-transform: uppercase; letter-spacing: 1px; margin-top: 25px; border-bottom: 1px solid #ddd; padding-bottom: 5px; }
+    .summary { font-style: italic; color: #555; margin-bottom: 20px; }
+    .experience-item, .education-item { margin-bottom: 20px; }
+    .job-title { font-weight: bold; }
+    .company { color: #3498db; }
+    .date { font-size: 12px; color: #7f8c8d; float: right; }
+    .skills { display: flex; flex-wrap: wrap; gap: 8px; }
+    .skill-tag { background: #e8f4f8; color: #2c3e50; padding: 4px 12px; border-radius: 15px; font-size: 12px; }
+  </style>
+</head>
+<body>
+  <div class="header">
+    <div class="name">${data.name || 'Your Name'}</div>
+    <div class="contact">
+      ${data.email || ''} | ${data.phone || ''} | ${data.location || ''}<br>
+      ${data.linkedin ? `<a href="${data.linkedin}">${data.linkedin}</a>` : ''}
+      ${data.website ? `| <a href="${data.website}">${data.website}</a>` : ''}
+    </div>
+  </div>
+
+  <h2>Professional Summary</h2>
+  <p class="summary">${data.summary || ''}</p>
+
+  <h2>Experience</h2>
+  ${data.experience || '<div class="experience-item"><span class="job-title">Position</span> at <span class="company">Company</span></div>'}
+
+  <h2>Education</h2>
+  ${data.education || '<div class="education-item">Degree - Institution</div>'}
+
+  <h2>Skills</h2>
+  <div class="skills">
+    ${data.skills || '<span class="skill-tag">Skill</span>'}
+  </div>
+</body>
+</html>`,
+
+  letter: (data) => `
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <style>
+    body { font-family: 'Times New Roman', serif; margin: 60px; color: #333; line-height: 1.8; font-size: 14px; }
+    .sender-info { margin-bottom: 40px; }
+    .date { margin-bottom: 40px; }
+    .recipient-info { margin-bottom: 40px; }
+    .body { margin-bottom: 40px; text-align: justify; }
+    .closing { margin-top: 40px; }
+    .signature { margin-top: 60px; }
+  </style>
+</head>
+<body>
+  <div class="sender-info">
+    <strong>${data.senderName || ''}</strong><br>
+    ${data.senderAddress || ''}<br>
+    ${data.senderCity || ''}, ${data.senderState || ''} ${data.senderZip || ''}
+  </div>
+
+  <div class="date">${data.date || new Date().toLocaleDateString('en-US', { year: 'numeric', month: 'long', day: 'numeric' })}</div>
+
+  <div class="recipient-info">
+    ${data.recipientName || ''}<br>
+    ${data.recipientTitle ? data.recipientTitle + '<br>' : ''}
+    ${data.recipientCompany ? data.recipientCompany + '<br>' : ''}
+    ${data.recipientAddress || ''}<br>
+    ${data.recipientCity || ''}, ${data.recipientState || ''} ${data.recipientZip || ''}
+  </div>
+
+  <div class="body">
+    <p>Dear ${data.recipientName || 'Sir/Madam'},</p>
+    <p>${data.body || ''}</p>
+  </div>
+
+  <div class="closing">
+    ${data.closing || 'Sincerely'},
+  </div>
+
+  <div class="signature">
+    ${data.senderName || ''}
+  </div>
+</body>
+</html>`,
+
+  contract: (data) => `
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <style>
+    body { font-family: 'Times New Roman', serif; margin: 50px; color: #333; line-height: 1.6; font-size: 12px; }
+    .title { text-align: center; font-size: 24px; font-weight: bold; margin-bottom: 30px; text-transform: uppercase; }
+    .date { text-align: center; margin-bottom: 30px; }
+    h2 { font-size: 14px; margin-top: 25px; }
+    .parties { margin-bottom: 30px; }
+    .section { margin-bottom: 20px; text-align: justify; }
+    .signatures { margin-top: 60px; display: flex; justify-content: space-between; }
+    .signature-block { width: 45%; }
+    .signature-line { border-top: 1px solid #333; margin-top: 60px; padding-top: 10px; }
+  </style>
+</head>
+<body>
+  <div class="title">${data.contractTitle || 'SERVICE AGREEMENT'}</div>
+  <div class="date">Effective Date: ${data.effectiveDate || new Date().toLocaleDateString()}</div>
+
+  <div class="parties">
+    <p>This Agreement is entered into by and between:</p>
+    <p><strong>${data.party1Name || 'Party 1'}</strong> ("${data.party1Label || 'Provider'}")<br>
+    Address: ${data.party1Address || ''}</p>
+    <p>AND</p>
+    <p><strong>${data.party2Name || 'Party 2'}</strong> ("${data.party2Label || 'Client'}")<br>
+    Address: ${data.party2Address || ''}</p>
+  </div>
+
+  <div class="section">
+    <h2>1. PURPOSE</h2>
+    <p>${data.purpose || ''}</p>
+  </div>
+
+  <div class="section">
+    <h2>2. TERM</h2>
+    <p>This Agreement shall be effective for a period of ${data.term || '12 months'} from the Effective Date.</p>
+  </div>
+
+  <div class="section">
+    <h2>3. OBLIGATIONS</h2>
+    <p>${data.obligations || ''}</p>
+  </div>
+
+  <div class="section">
+    <h2>4. COMPENSATION</h2>
+    <p>${data.compensation || ''}</p>
+  </div>
+
+  <div class="section">
+    <h2>5. TERMINATION</h2>
+    <p>${data.termination || ''}</p>
+  </div>
+
+  <div class="section">
+    <h2>6. GOVERNING LAW</h2>
+    <p>This Agreement shall be governed by the laws of ${data.governingLaw || 'the applicable jurisdiction'}.</p>
+  </div>
+
+  <div class="signatures">
+    <div class="signature-block">
+      <div class="signature-line">
+        ${data.party1Name || 'Party 1'}<br>
+        ${data.party1Label || 'Provider'}
+      </div>
+    </div>
+    <div class="signature-block">
+      <div class="signature-line">
+        ${data.party2Name || 'Party 2'}<br>
+        ${data.party2Label || 'Client'}
+      </div>
+    </div>
+  </div>
+</body>
+</html>`
+};

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

@@ -0,0 +1,28 @@
+export const PAGE_FORMATS: Record<string, { width: number; height: number }> = {
+  A4: { width: 210, height: 297 },
+  Letter: { width: 216, height: 279 },
+  Legal: { width: 216, height: 356 },
+  A3: { width: 297, height: 420 },
+  A5: { width: 148, height: 210 },
+  Tabloid: { width: 279, height: 432 },
+};
+
+export interface GenerateOptions {
+  content?: string;
+  contentType: "markdown" | "html" | "text";
+  format: string;
+  orientation: "portrait" | "landscape";
+  margin: { top: string; right: string; bottom: string; left: string };
+  header?: string;
+  footer?: string;
+  displayHeaderFooter: boolean;
+  printBackground: boolean;
+  css?: string;
+  title?: string;
+  author?: string;
+  subject?: string;
+  filename?: string;
+  template?: string;
+  data?: Record<string, string>;
+  url?: string;
+}

package/skills/pdf-read/SKILL.md

@@ -28,29 +28,29 @@ Read and extract text from PDF files. Supports multiple PDFs at once, page-range
 
 ```bash
 # Read entire PDF
-pdf-read read document.pdf
+skills run pdf-read -- read document.pdf
 
 # Read specific pages
-pdf-read read report.pdf --pages 1-5
+skills run pdf-read -- read report.pdf --pages 1-5
 
 # Read multiple PDFs
-pdf-read read file1.pdf file2.pdf file3.pdf
+skills run pdf-read -- read file1.pdf file2.pdf file3.pdf
 
 # Read in chunks of 10 pages
-pdf-read read large-book.pdf --chunk-size 10
+skills run pdf-read -- read large-book.pdf --chunk-size 10
 
 # Get metadata only
-pdf-read info document.pdf
+skills run pdf-read -- info document.pdf
 
 # Output as JSON with page structure
-pdf-read read document.pdf --format json --output result.json
+skills run pdf-read -- read document.pdf --format json --output result.json
 ```
 
-## Environment Variables
+## Runtime
 
-- None required (pure local processing)
+This is a premium remote skill. Authenticate with `skills auth login` and run it through Skills MCP or `skills run`.
 
 ## Requirements
 
-- Bun runtime
-- pdf-parse (auto-installed)
+- Skills CLI/MCP registration
+- Hosted Skills runtime access

package/skills/pdf-to-dataset/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: pdf-to-dataset
+description: Extract tables, forms, invoices, and semi-structured PDF content into CSV and JSON datasets through the hosted Skills runtime.
+---
+
+# PDF to Dataset
+
+Convert PDF content into structured datasets and extraction reports. The implementation runs through the hosted Skills runtime, so agents get the instruction file and generated artifacts without receiving parser source, scripts, or model code.
+
+## What It Does
+
+- Extracts table-like rows, key-value fields, invoice fields, and semi-structured records from PDFs.
+- Produces `dataset.json`, `dataset.csv`, `schema.json`, `extraction-report.md`, and `manifest.json`.
+- Includes confidence notes and source metadata for review.
+- Supports schema hints for naming columns and expected fields.
+- Stores generated outputs as run artifacts for later download.
+
+## Usage
+
+```bash
+skills run pdf-to-dataset -- --input ./invoice.pdf --schema "invoice_number,date,total,vendor"
+```
+
+```bash
+skills run pdf-to-dataset -- --input ./reports --mode tables --output ./exports/pdf-data
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--input <path-or-url>` | PDF file, folder, or URL | required |
+| `--schema <fields>` | Comma-separated field hints | inferred |
+| `--mode <mode>` | `tables`, `forms`, `invoice`, or `auto` | auto |
+| `--output <dir>` | Output directory | current run export directory |
+| `--pages <ranges>` | Page ranges like `1-3,8` | all pages |
+
+## Requirements
+
+- Authenticate with `skills auth login`.
+- Keep the Skills MCP server registered with your agent:
+
+```bash
+skills mcp --register all
+```

package/skills/pdf-to-dataset/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "pdf-to-dataset",
+  "version": "0.1.0",
+  "description": "Extract PDF tables and forms into CSV and JSON datasets through the hosted Skills runtime",
+  "type": "module",
+  "bin": {
+    "pdf-to-dataset": "src/index.ts"
+  },
+  "dependencies": {}
+}

package/skills/pdf-to-markdown/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: pdf-to-markdown
+description: Convert PDFs into clean markdown through the hosted Skills runtime.
+---
+
+# PDF to Markdown
+
+Convert a PDF into clean, structured markdown using the hosted Skills runtime. The implementation runs remotely so local agent installs only need this usage contract; no parser source, scripts, or hosted runtime code is copied to the user's machine.
+
+## What It Does
+
+- Extracts text, headings, lists, and tables from PDFs.
+- Preserves useful page boundaries and source references.
+- Cleans noisy extraction output into readable markdown.
+- Supports selected page ranges for large documents.
+- Uses the platform runtime for paid execution and billing.
+
+## Runtime
+
+This is a premium remote skill. The hosted runtime handles extraction and cleanup after deterministic PDF processing. Agents should run it through Skills MCP or the CLI, not through copied local source.
+
+## Usage
+
+```bash
+skills run pdf-to-markdown --input ./report.pdf --output ./report.md
+```
+
+```bash
+skills run pdf-to-markdown --input ./contract.pdf --pages 1-5,12 --preserve-pages
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--input <path-or-url>` | PDF file path or URL | required |
+| `--pages <ranges>` | Page ranges like `1-5,8,10-12` | all pages |
+| `--output <path>` | Save markdown to a file | stdout |
+| `--preserve-pages` | Include page boundary comments | false |
+| `--table-mode <mode>` | `markdown` or `html` table output | markdown |
+
+## Requirements
+
+- Authenticate with `skills auth login`.
+- Keep the Skills MCP server registered with your agent:
+
+```bash
+skills setup agents
+```

package/skills/pdf-to-markdown/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "pdf-to-markdown",
+  "version": "0.1.0",
+  "description": "Convert PDFs into clean markdown through the hosted Skills runtime",
+  "type": "module",
+  "bin": {
+    "pdf-to-markdown": "src/index.ts"
+  },
+  "dependencies": {}
+}