galley

Opens local review surfaces for agent-authored HTML artifacts and returns human feedback as structured prompts.

Updated Jul 28, 2026
One-click install
npx skills add https://github.com/vinzenz/workflows --skill galley-vinzenz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: galley
Source: https://github.com/vinzenz/workflows/tree/main/.agents/skills/galley
Command: npx skills add https://github.com/vinzenz/workflows --skill galley-vinzenz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agent-generated HTML artifacts like diagrams, plans, and UI mockups are hard to review in plain chat, and human feedback often arrives as vague prose. Galley provides a local review surface where humans annotate artifacts directly, returning source-anchored comments as structured prompts the agent can act on. ## Core Features & Use Cases - Live review sessions: Open or resume a local review surface for an HTML artifact, then block on galley wait until feedback, findings, or session end arrives. - Render audits and playbooks: Run galley check for headless render audits before involving a human, and pull authoring playbooks (diagram, table, comparison, plan, code, input, slides) plus design-system inspection via galley design. - Use Case: You are planning a database migration. Write a plan artifact to .galley/migration.html, run galley check to fix render issues, open the review surface, and wait for the human's anchored comments before implementing. ## Quick Start Ask the agent to create an HTML plan artifact for your current task and open it for visual review with galley, then wait for your inline feedback.

Frequently Asked Questions about galley

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review an agent-generated HTML artifact with galley?▼

Write the HTML artifact to disk, run galley check to fix render findings, then run galley <artifact.html> to open the review surface. Use galley wait <artifact.html> --reply with a summary to block until the human returns feedback.

What kinds of artifacts work best for visual review?▼

Galley suits architecture diagrams, migration plans, option comparisons, UI mockups, dense tables, and code reviews. Playbooks exist for diagram, table, comparison, plan, code, input, and slides artifact types.

When should I not use galley for review?▼

Skip galley for short text answers, tiny code changes, or anything reviewable directly in chat. Also avoid it when no HTML artifact will be written or when slides were not explicitly requested.

What happens if the galley wait command is interrupted?▼

Feedback is not lost when galley wait is interrupted; simply re-run the command to resume blocking. The wait command must stay attached to the active agent turn or a tracked background job.

Does galley inject a design system into my artifact?▼

No, galley never injects a design system. It inspects the target project with galley design for theme tokens and component libraries, and offers recipes only as text you paste yourself.