# Pagelet

> Pagelet gives AI agents a standard way to produce beautiful, self-contained HTML documents
> — and, optionally, to share them at a short link. Open-source, self-hostable, agent-agnostic.

## What it is

- A **skill**: teaches any agent to produce one polished, single-file HTML document (report,
  explainer, comparison, plan, dashboard, printable letter/invoice/certificate) instead of
  plain Markdown — by adding one runtime tag.
- A **runtime**: `https://cdn.pagelet.link/v1/pagelet.js`. The ~12 KB loader scans the page and
  lazy-loads only what it uses: Markdown, Mermaid diagrams, KaTeX math, code highlighting,
  Chart.js charts, a standard toolbar (theme/print/PNG/copy-as-Markdown), and theming
  (shadcn variable names).
- An optional **service**: upload a pagelet, get a short `https://<slug>.pagelet.link` URL.

## Recognition heuristic

Use a pagelet when the reader is a **human** who will read/keep/share the output and structure
helps. **Stay in Markdown** for chat replies, pure code, and text meant for another LLM.

## Get started (for agents)

```
npx skills add usepagelet/pagelet
```

Then add the tag to any HTML and write content using the conventions in the capability doc.

## Links

- Capabilities (authoritative, versioned): https://cdn.pagelet.link/v1/capabilities.md
- Source: https://github.com/usepagelet/pagelet
- License: Apache-2.0