gooseworks-ai/goose-skills / skills/shared/goose-graphics
goose-graphics
VerifiedPortable visual skill pack for the Agent Skills ecosystem (Claude Code, Claude Desktop, Claude Cowork, Claude Design, Goose, Cursor, Codex). Discovers community-published styles + formats via the gooseworks CLI, runs an extract-style workflow on reference images, and exports rendered PNGs via Playwright.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 4.9 KB |
| SKILL.md | skill md | 20.3 KB |
| extract-style.md | markdown | 17.9 KB |
| screenshot/.gitignore | other | 13 B |
| screenshot/fetch-full-tweet.js | script | 3.6 KB |
| screenshot/fetch-tweet.js | script | 7.2 KB |
| screenshot/package-lock.json | manifest | 1.7 KB |
| screenshot/package.json | manifest | 237 B |
| screenshot/screenshot.js | script | 11.2 KB |
| skill.meta.json | config | 559 B |
| sources/ascii-art.md | markdown | 12.3 KB |
| sources/unsplash.md | markdown | 10.4 KB |
README.md
View on GitHub# goose-graphics — Agent Skills pack for visual graphics
`goose-graphics` is a portable visual skill pack for the Agent Skills ecosystem. Styles and formats live in the central Gooseworks library — fetched on demand via `npx gooseworks` instead of bundled into this repo. The skill pairs that catalog with an extract-style workflow for reference images, an Unsplash + ASCII art image-sourcing layer, and a Playwright-based HTML-to-PNG export pipeline.
Any host that reads `SKILL.md` can load the pack — Claude Code agents calling it for automated render, Goose pipelines wiring it into content generation, Cursor/Codex projects picking it up via `.cursor/rules/` or `~/.codex/skills/`. Each published style ships a slim DESIGN.md spec, fetchable via `npx gooseworks styles get <slug>`, that can also be uploaded directly into Claude Design as a design-system scaffold.
## Host compatibility
`SKILL.md` auto-loads on most Agent Skills hosts once the pack is installed at the right path. Claude Design is the one host that does not auto-load skill packs — instead, it consumes individual style files (DESIGN.md) one at a time, fetched on demand via `npx gooseworks styles get <slug>`.
| Host | Install | Notes |
|---|---|---|
| Claude Code | `npx gooseworks@latest install --claude --with goose-graphics` | Installs with the GooseWorks skills |
| Claude Desktop | (same install as above) | Desktop reads the same Claude skills |
| Claude Cowork | (same install as above) | Built on Claude Desktop |
| Cursor | `npx gooseworks@latest install --cursor --with goose-graphics` | |
| Codex (OpenAI) | `npx gooseworks@latest install --codex --with goose-graphics` | |
| Claude Design | `npx gooseworks styles get <slug>` → upload the resulting DESIGN.md via CD's "Create new design system" | Per-style DESIGN.md upload; no CLI sync |
## Directory Structure
```
goose-graphics/
SKILL.md # Entry-point skill (router)
README.md # This file
skill.meta.json # catalog metadata
.claude-plugin/plugin.json # Claude Code plugin descriptor
extract-style.md # Derive a publishable custom style from a reference image
sources/
unsplash.md, ascii-art.md # Image-sourcing helpers
screenshot/
screenshot.js, package.json # Playwright HTML-to-PNG export
```
Styles, formats, and example renders live in the central Gooseworks library — discoverable via `npx gooseworks styles list` and `npx gooseworks formats list`.
## Discovering styles and formats
```bash
npx gooseworks styles list
npx gooseworks styles search "warm editorial"
npx gooseworks styles get <slug> # returns the slim DESIGN.md
npx gooseworks formats list
npx gooseworks formats get <slug> # returns the format spec
```
Always list or search before assuming a slug exists — the catalog is community-driven.
## Args-based Invocation
This skill supports three invocation modes. See SKILL.md §2 for full details.
```bash
# Full args — one-shot generate (fastest)
/goose-graphics --style matt-gray --format carousel --brief "How founders find their first 100 customers"
# Reference-driven — extract style from image, then build
/goose-graphics --ref ~/Desktop/mood.png --format poster --brief "Studio open house"
# Partial args — Claude asks only for what's missing
/goose-graphics --style deep-ocean --format slides
# No args — full interactive flow
/goose-graphics
```
Flags:
- `--style <slug>` — any slug returned by `npx gooseworks styles list`
- `--format <slug>` — any slug returned by `npx gooseworks formats list`
- `--brief "..."` — topic / content description
- `--ref <image-path>` — use image-to-style extraction instead of a preset
## Publishing styles and formats
When the user creates a new aesthetic via `extract-style.md` (or `/goose-graphics-create-style`) and wants other agents to discover it, publish to the catalog:
```bash
cd <working-dir-with-bundle>
npx gooseworks styles publish # uses gooseworks-style.json
npx gooseworks formats publish # uses gooseworks-format.json
```
See SKILL.md §17 for the manifest shapes.
## Image Sourcing
- **Unsplash** — Search and embed high-quality stock photography (requires `UNSPLASH_ACCESS_KEY` environment variable).
- **ASCII art** — Generate decorative ASCII art elements via CSS/HTML.
## Installation
```bash
cd screenshot && npm install && npx playwright install chromium
```
To install it on its own with the GooseWorks CLI:
```bash
npx gooseworks@latest install --claude --with goose-graphics
```
See `skill.meta.json` for the catalog metadata.
## Usage
Invoke via `/goose-graphics` in Claude Code. The skill walks you through format selection, style choice, image sourcing, and HTML generation, then automatically exports PNGs — or jump straight to generate by passing args (see above).
## Testing
There is no automated testing harness for this skill yet.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |