codex-image-gallery

Design Community

Repo stars 0
Author updated Aug 24, 2026, 03:33 PM
Author repo claude-code-skills

Interpretation is structured for decision-making; original keeps the upstream SKILL.md unchanged.

Decide Fit First

Core job: Start or reuse a self-contained local web gallery for browsing Codex-generated images. Use when the user asks to browse Codex ge…
Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

Structure: The skill is organized around “Quick Start”, “Workflow”, “Image Root”, “Validation”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
Invocation: Name codex-image-gallery directly; if the source includes slash commands, start with the command and then add task context.
Validation: Start small and check whether the result follows “Quick Start / Workflow / Image Root” before expanding.

Boundaries And Review

Dependencies: It usually needs no extra API key, so start with a small validation task.
Permissions: Declared permissions include read / shell-exec; ask the agent to state file, command, and rollback boundaries before acting.
Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.

Codex Image Gallery

Start a local browser gallery for Codex image outputs. This skill is self-contained: the server lives in scripts/server.mjs, and the UI template lives in assets/index.html.

Quick Start

Run commands from this skill directory, the directory containing this SKILL.md.

node scripts/server.mjs

The server prints the actual URL. It starts at http://127.0.0.1:8765/ and tries later ports if the default is occupied.

Workflow

Check the default URL first:

node -e 'fetch("http://127.0.0.1:8765/api/images").then(r => r.json()).then(j => console.log(j.rootPath, j.items.length)).catch(() => process.exit(1))'

If this succeeds, reuse the running server at http://127.0.0.1:8765/.

If the API check fails, check for a running server process:
```
pgrep -fl 'node .*server\.mjs' || true
```
When a process exists but the default URL fails, inspect its stdout or try likely later ports because the server auto-increments when a port is occupied.

Verify any reused URL before reporting success:

node -e 'fetch("http://127.0.0.1:8765/api/images").then(r => r.json()).then(j => console.log(j.rootPath, j.items.length))'

If the server chose another port, use that port.

Start the server if none is running:
```
node scripts/server.mjs
```
Keep the process running for the user and read stdout for the URL.
Open the browser unless the user asks for URL-only:
```
open http://127.0.0.1:8765/
```

Image Root

Default image root:

~/.codex/generated_images

Use a different folder with:

GALLERY_ROOT=/path/to/images node scripts/server.mjs

Validation

Before declaring the skill healthy after edits, run:

node --check scripts/server.mjs

Then start the server and verify:

GET /api/images returns JSON with rootPath and items
/images/<relative-path> returns image content for at least one listed item
The page loads from the bundled assets/index.html

Response

Report the URL, image root, whether the server was reused or newly started, and any verification failure. Keep the answer short.

Fluxly profile Author and license come from source; runtime, permissions, and network are Fluxly detections or estimates

Fluxly category: Design
Author-declared agents: No explicit declaration found; this is not inferred or tested compatibility
Static check: 88 / 100 · heuristic scan, not runtime safety proof
Author / version / license: @daymade · no license declared
Fluxly token estimate: Lean
Fluxly setup estimate: Guided setup
External API key: No requirement detected
Detected OS requirements: macOS · Linux · Windows
Runtime requirements: Node.js
Detected file/system behavior: Read-only
Shell exec
Detected network behavior: External requests
Install commands: None (reference only)

Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.

Heads up: 未限定 allowed-tools，默认拥有全部工具权限。

Output preview codex-image-gallery.preview

The current SKILL.md does not define a fixed output example.

SKILL.md SKILL.md

# Codex Image Gallery

Start a local browser gallery for Codex image outputs. This skill is self-contained: the server lives in `scripts/server.mjs`, and the UI template lives in `assets/index.html`.

## Quick Start

Run commands from this skill directory, the directory containing this `SKILL.md`.

```bash
node scripts/server.mjs
```

The server prints the actual URL. It starts at `http://127.0.0.1:8765/` and tries later ports if the default is occupied.

## Workflow

1. Check the default URL first:

   ```bash
   node -e 'fetch("http://127.0.0.1:8765/api/images").then(r => r.json()).then(j => console.log(j.rootPath, j.items.length)).catch(() => process.exit(1))'
   ```

   If this succeeds, reuse the running server at `http://127.0.0.1:8765/`.

2. If the API check fails, check for a running server process:

   ```bash
   pgrep -fl 'node .*server\.mjs' || true
   ```

   When a process exists but the default URL fails, inspect its stdout or try likely later ports because the server auto-increments when a port is occupied.

3. Verify any reused URL before reporting success:

   ```bash
   node -e 'fetch("http://127.0.0.1:8765/api/images").then(r => r.json()).then(j => console.log(j.rootPath, j.items.length))'
   ```

   If the server chose another port, use that port.

4. Start the server if none is running:

   ```bash
   node scripts/server.mjs
   ```

   Keep the process running for the user and read stdout for the URL.

5. Open the browser unless the user asks for URL-only:

   ```bash
   open http://127.0.0.1:8765/
   ```

## Image Root

Default image root:

```text
~/.codex/generated_images
```

Use a different folder with:

```bash
GALLERY_ROOT=/path/to/images node scripts/server.mjs
```

## Validation

Before declaring the skill healthy after edits, run:

```bash

…

Evidence boundary and execution chain

Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.

sections -> Quick Start → Workflow → Image Root → Validation → Response
terms    -> Start a local browser gallery for Codex image outputs. · Run commands from this skill directory, the directory containing this SKILL.md. · The server prints the actual URL. · If this succeeds, reuse the running server at http://127.0.0.1:8765/. · If the server chose another port, use that port. · Keep the process running for the user and read stdout for the URL. · Report the URL, image root, whether the server was reused or newly started, and any verification failure.
files/cmd -> scripts/server.mjs · assets/index.html · http://127.0.0.1:8765/ · GET /api/images · rootPath · items · /images/<relative-path>
body sha256 -> 349465468309