Skip to content

gooseworks-ai/goose-skills / skills/shared/goose-graphics

goose-graphics

Verified

Portable 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.

FileKindSize
README.mdmarkdown4.9 KB
SKILL.mdskill md20.3 KB
extract-style.mdmarkdown17.9 KB
screenshot/.gitignoreother13 B
screenshot/fetch-full-tweet.jsscript3.6 KB
screenshot/fetch-tweet.jsscript7.2 KB
screenshot/package-lock.jsonmanifest1.7 KB
screenshot/package.jsonmanifest237 B
screenshot/screenshot.jsscript11.2 KB
skill.meta.jsonconfig559 B
sources/ascii-art.mdmarkdown12.3 KB
sources/unsplash.mdmarkdown10.4 KB
# 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.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 323kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 323kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 323kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall