kamy

Kamy — PDF generation + e-signature

Kamy renders pixel-perfect PDFs from HTML/Handlebars templates via a hosted Chromium pipeline, and sends those PDFs for legally-binding e-signature with a built-in audit trail. This skill teaches you when and how to call the Kamy API on the user's behalf.

When to use this skill

Activate whenever the user asks to:

• "Generate / create / make a PDF…"
• Produce an invoice, receipt, quote, estimate, statement, contract, agreement, certificate, report, payslip, brochure, flyer, or any printable document.
• Convert a web page or HTML snippet to a PDF.
• Build a document pipeline (cron-driven monthly statements, webhook- triggered receipts, etc.).
• Send a document for signature — NDAs, contracts, offer letters, consent forms, HR paperwork, vendor agreements. Kamy issues a sign link the recipient opens in their browser, captures the signature with an audit trail, and seals the result with PAdES-grade cryptography.
• Verify a signed PDF — /verify/<sha256> is the canonical "is this document genuinely Kamy-sealed?" answer.

Do not activate for:

• Extracting text or data from PDFs (use a separate OCR / parsing tool).
• Producing non-PDF formats (Word, Excel, PowerPoint).
• Producing non-PDF formats (Word, Excel, PowerPoint).

Setup

The user needs a Kamy API key from https://kamy.dev/dashboard/keys. Read it from process.env.KAMY_API_KEY. If it's not set, ask the user to provide one before running any code.

pnpm add @kamydev/sdk

Three render modes

1. Template + data (preferred)

Use a stored template. Templates live in the user's Kamy dashboard and accept JSON data:

import { Kamy } from "@kamydev/sdk";

const kamy = new Kamy({ apiKey: process.env.KAMY_API_KEY! });
const { id, url, bytes, warnings } = await kamy.render({
  template: "invoice",
  data: {
    invoice: { number: "INV-2026-0142", issuedAt: "2026-04-23" },
    customer: { name: "Acme Corp", email: "[email protected]" },
    lineItems: [
      { description: "Consulting (April)", qty: 40, unitPrice: 150 },
    ],
    totals: { subtotal: 6000, tax: 600, total: 6600 },
  },
  options: { format: "a4", inlineImages: true },
});

console.log("PDF ready:", url);
for (const w of warnings ?? []) {
  console.warn(`[${w.code}] ${w.message}`);
}