# lightpanda-browser

A skill that teaches your agent to run Lightpanda: install the Zig headless browser, start a CDP server, and hook Playwright or Puppeteer to it.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1500 installs · ★ 88
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/lightpanda-browser/SKILL.md
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/skills/lightpanda-browser

## What it does

Lightpanda is a headless browser written from scratch in Zig. It is not built on Chromium, Blink or WebKit, and it runs JavaScript through V8. The project claims roughly 9x less memory and 11x faster execution than Chrome headless. The skill hands your agent ready-made recipes: installation, CLI, CDP server, integrations and scraping patterns.

Inside you get install commands for macOS on Apple Silicon, Linux on x86_64 and Docker, a breakdown of CLI flags, and code samples. The agent can walk you through starting the server with `./lightpanda serve` and connecting from Playwright, Puppeteer, chromedp or Python. There are worked scenarios too: looping over a list of URLs, pulling structured data out of product cards, running the browser next to your scraper in Docker Compose.

The browser is in beta, so treat it that way before shipping anything to production. There is no visual rendering, only DOM and JS, which means pages that paint content visually may not return what you expect. Web API support is partial. The license is AGPL-3.0, so check the terms if you embed Lightpanda in your own product. Telemetry can be turned off with `LIGHTPANDA_DISABLE_TELEMETRY`.

## Requirements
- Works with: Playwright, Chrome

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill lightpanda-browser -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/lightpanda-browser/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/lightpanda-browser/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill lightpanda-browser -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/lightpanda-browser/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill lightpanda-browser -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/lightpanda-browser/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/trending-skills lightpanda-browser
```

2. **Manually: put the files in place**
- File: `.github/skills/lightpanda-browser/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill lightpanda-browser -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/trending-skills --path skills/lightpanda-browser
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/lightpanda-browser/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill lightpanda-browser -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/lightpanda-browser/SKILL.md

## When to use it
- run a headless browser for an agent without Chromium
- cut memory use when batch-scraping many pages
- connect Playwright to a Lightpanda CDP server
- extract structured data from product cards
- run the browser and a scraper in one Docker Compose file

## Example prompts
- Install Lightpanda and show me how to start the CDP server on port 9222
- Connect Playwright to Lightpanda with connectOverCDP and grab the page title
- Write a script that loops over a list of URLs through Lightpanda and collects titles and links

## Similar
- [lightpanda](https://affpapa.org/en/nevibecode/skills/lightpanda.md) — skill · 1300 installs
- [browser-qa](https://affpapa.org/en/nevibecode/skills/browser-qa.md) — skill · 4900 installs
- [safe-browser](https://affpapa.org/en/nevibecode/skills/safe-browser.md) — skill · 1700 installs
- [anti-detect-browser](https://affpapa.org/en/nevibecode/skills/anti-detect-browser.md) — skill · 137300 installs
- [dev-browser](https://affpapa.org/en/nevibecode/skills/dev-browser.md) — skill · 2500 installs
- [adspower-antidetect-browser](https://affpapa.org/en/nevibecode/skills/adspower-antidetect-browser.md) — skill · 821 installs

From the same set: [reason-machines/trending-skills](https://affpapa.org/en/nevibecode/by/reason-machines/trending-skills.md) — 49 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md