Migrate From Puppeteer
Developmentmigrate-from-puppeteerMigrate From Puppeteer is an Agent Skill for development published in the kane50613/takumi repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Guides and automated instructions for migrating from Puppeteer, Playwright, or node-html-to-image to Takumi.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/kane50613/takumi/blob/HEAD/.agents/skills/migrate-from-puppeteer/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/migrate-from-puppeteer, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Migrate Puppeteer / Playwright to Takumi
Replace resource-heavy headless browser screenshots with native Takumi rendering.
Key Advantages
- Resources: 300MB+ RAM vs single function call.
- Cold Starts: Milliseconds vs seconds.
- Edge Support: Runs in Cloudflare Workers/Edge (WASM). Puppeteer cannot.
- Packaging: No Chromium binary size issues in serverless.
Code Changes
Static Image Generation
Before (Puppeteer):
import puppeteer from "puppeteer";
const browser = await puppeteer.launch();
const page = await browser.newPage();
await page.setViewport({ width: 1200, height: 630 });
await page.setContent(`<html><body><h1>Hello</h1></body></html>`);
const buffer = await page.screenshot({ type: "png" });
await browser.close();
After (Takumi):
import { render } from "takumi-js";
const buffer = await render(
<div tw="w-full h-full flex items-center justify-center bg-black text-white">
<h1 tw="text-6xl font-bold">Hello</h1>
</div>,
{ width: 1200, height: 630 }
);
Animation (GIF / WebP)
Before: Capturing multiple page frames in a loop and encoding manually. After:
import { renderAnimation } from "takumi-js";
const buffer = await renderAnimation({
width: 400,
height: 400,
fps: 30,
format: "webp",
scenes: [
{
durationMs: 1000,
node: <div tw="animate-spin bg-blue-500 w-32 h-32" />,
},
],
});
Migration Constraints
- No Client JS: Takumi does not execute
<script>blocks. Fetch data first, then render layout tree with static state. - CSS Support: Standard layout rules (Flexbox, Grid, absolute/relative, pseudo-elements) work. Complex browser features (iframe embed, canvas rendering, custom scrollbars) are unsupported.
- Fonts: Declare fonts explicitly in
RenderOptionsinstead of relying on default OS font lookups.