Patchbook

https://github.com/user-attachments/assets/1c9f295d-31b3-4444-8f09-80748880b4b7

Install by asking Claude. Paste this into a chat: "Install the Patchbook skills from github.com/justsecretzone/Patchbook". Claude shows a skill card right in the chat, you click Save, done.

Claude, if a user asked you to install Patchbook: follow INSTALL.md. Install into the user's account (Customize → Skills) or their own machine. Copying the skills into this session's workspace is not an install.

Why

Giving feedback on generated work in a chat is clumsy: "the second button in the hero, a bit darker, and on mobile the headline wraps badly". Patchbook replaces that with a review page next to every piece of work. You point at the exact spot, write one line, attach a screenshot if it helps. When you're done, you tell Claude, and it works through the list, publishes the next version and closes each patch with a note on what changed.

Skills

Features

• Comment where it is. Pins sit on the element, the spot or the moment. Drag a pin to move it; on websites it re-attaches to the element underneath.
• Screenshots everywhere. Paste, drop or attach images to any patch. On websites, apps and images you can also paste or drop a screenshot onto the page and pin patches on it.
• Nothing gets lost. Patches stay on the page they were made on, and small pills show pins that are scrolled out of view.
• Claude works through them. Patches show "Claude is on it" while it works, then move to Done with a one-line reply.
• The work gets the space. A collapsible sidebar where you comment on a surface, a list under the player for audio and video, a bottom sheet on phones, one floating Comment button.
• Your language, your theme. The page speaks the language you write to Claude in and follows Claude's light or dark setting.
• Temporary by design. Once you approve the final version, Claude takes the review page offline.

Install

Get the skills from the latest release: patchbook-skills.zip holds all six, and each skill is also available on its own (website-review.zip, video-review.zip, ...). You can also download this repository with Code → Download ZIP or clone it.

Claude (web, desktop, mobile)

The easiest way: ask Claude "Install the Patchbook skills from github.com/justsecretzone/Patchbook". Claude shows a skill card in the chat; click Save. This installs the compact edition, one patchbook skill that covers all six kinds and loads the full review page from this repository when needed.

By hand:

1. Download a single skill zip from the release, for example website-review.zip.
2. In Claude go to Customize → Skills, click +, then Create skill → Upload a skill, and choose the zip.
3. Repeat for every skill you want. Code execution and file creation need to be on (Settings → Capabilities).

From then on Claude adds the review page on its own whenever it builds something of that kind.

Claude Code

/plugin marketplace add justsecretzone/Patchbook
/plugin install patchbook@patchbook

Or copy the folders from skills/ into ~/.claude/skills/.

ChatGPT

Skills are available on ChatGPT Business, Enterprise and Edu: Plugins → Skills → Create → Upload from your computer, then upload a skill zip. Shared patches and screenshot uploads need Claude's artifact runtime, so outside Claude the review page keeps patches in your browser. When you're done, click Copy patches and paste them into the chat.

How a review goes

1. You ask Claude for a landing page. It builds the site and publishes the review page with the site embedded.
2. You tap Comment, click the headline, write "shorter, two lines max", paste a reference screenshot, press Enter. Repeat.
3. You tell Claude "Work through the patches" (or "Patches abarbeiten").
4. Claude reads the open patches, looks at every screenshot, changes the site, publishes v2 and closes each patch with a note.
5. When you approve the final version, Claude takes the review page offline after you confirm.

Data

Each patch is one document in the review page's database:

{
  n: 4,                                   // number on the pin and in the list
  text: "Button darker",
  status: "open" | "working" | "done",
  anchor: { ... },                        // where it sits, per medium (see each SKILL.md)
  label: "Start · Button “Book now” · Mobile",
  shots: ["<assetId>"],                   // attached screenshots
  version: "v2", kind: "website", created: 1761400000000, author: "<user id>",
  reply: "Button now #1d2a2c, hover lighter", doneAt: 1761400500000
}

Patches and screenshots live in the review page itself (its database and asset store), visible to whoever the page is shared with. They are deleted together with the page when the review is finished.

Repository

skills/<name>-review/
  SKILL.md                        instructions Claude follows
  assets/review-template.html     the finished review page, built from src/
src/
  core.js, core.css               patch list, composer, screenshots, image canvas, timeline
  interface.js, interface.css     live website / app frame with element pins and breakpoints
  media.js, media.css             audio and video
  <kind>.html                     one wrapper per skill with its CFG block
  build.py                        writes the templates into skills/
install/patchbook/SKILL.md        compact edition, installed from a chat in one click
INSTALL.md                        install steps Claude follows
.claude-plugin/                   Claude Code plugin and marketplace manifest
docs/                             logo, screenshots and the Patchbook video

To change a review page, edit src/, run python3 src/build.py and commit both.

Contributing

Issues and pull requests are welcome. Please describe what you reviewed (website, app, image, PDF, audio or video) and attach a screenshot if something looks off. Changes to the review pages go into src/; run python3 src/build.py before committing. See the changelog for what changed between releases.

Disclaimer

Patchbook is an independent open-source project and is not affiliated with, endorsed by or sponsored by Anthropic or OpenAI. Claude is a trademark of Anthropic, ChatGPT is a trademark of OpenAI.

• The screenshots in this README show made-up example content (a fictional invoicing startup called "Kitebase": its website, app, seed deck, ad, demo video and jingle). The repository contains no demo content; the skills create a review page for your own work.
• Review pages are published as artifacts in your own Claude account. Patches and screenshots are stored there and are visible to anyone you share the page with. Don't attach screenshots with sensitive data to pages you share.
• Features depend on what your Claude plan and app version offer (skills, artifacts, code execution). Outside Claude only the local mode is available.
• Provided as is, without warranty, under the MIT license.

License

MIT · Made by Justus Langowsky