ccskill-gallery

name

ccskill-gallery

description

Skill for browsing media already generated by the ccskill series. Opens a read-only, cross-skill local gallery web app that aggregates the galleries of ccskill-nanobanana, ccskill-omniflash, ccskill-gptimage, and any future skill following the ccskill gallery store spec, without moving or copying files. Use when the user wants to see, browse, review, or look back at images or videos they have generated — e.g. "show me the gallery", "let me see what I've generated", "open the gallery", "ギャラリーを見せて", "生成した画像を一覧で見たい".

ccskill-gallery — Cross-skill Gallery Viewer

Overview

This skill does not generate any media. It opens a local web app that aggregates the galleries already produced by the other ccskill media-generation skills — ccskill-nanobanana, ccskill-omniflash, ccskill-gptimage, and any future skill that follows docs/store-spec.md — reading each skill's ~/.ccskill-<name>/gallery/ store in place, without moving or copying files.

Use this skill when the user wants to look back at what they have already generated. When the user wants to create something new, hand off to the matching generation skill (ccskill-nanobanana for images, ccskill-omniflash for video, ccskill-gptimage for images) instead.

Prerequisites

• The repository is installed via ./install.sh, which registers the ccskill-gallery command in ~/.local/bin.
• Python 3.9+ is required; the skill has no other dependency (no venv, no API key).
• If anything fails, run ccskill-gallery doctor to diagnose.

Usage

ccskill-gallery browse                  # start the server and open http://127.0.0.1:8770/
ccskill-gallery browse --port 9000      # use a different port
ccskill-gallery browse --bind 0.0.0.0   # for remote-dev: view from another machine
ccskill-gallery browse --no-open        # start the server without opening a browser
ccskill-gallery serve                   # run the same server in the foreground, never opens a browser
ccskill-gallery sources                 # list every gallery store that was discovered
ccskill-gallery doctor                  # diagnose the setup
ccskill-gallery uninstall
ccskill-gallery version
ccskill-gallery help

Options (browse)

Option	Description	Default
--port	Port to listen on	8770
--bind	Address to bind to	127.0.0.1
--no-open	Don't open a browser automatically	off

What the gallery shows

• A grid mixing images and videos from every discovered store, with a skill filter and a colored skill badge on each card.
• Videos preview on hover; images are lazy-loaded.
• A detail view per item: full metadata, prompt copy button, a ready-to-run re-generation command, and a download button.
• Keyboard navigation (←/→ to move between items, Esc to close) and state restore after a page reload.

Read-only guarantee

ccskill-gallery never writes into any skill's store. It only reads each store's index.json (rebuilding it in memory from <subdir>/*.json sidecar files if the manifest is missing or corrupt) and serves media files directly from the store's own directory. Nothing is moved, copied, or migrated.

Supported skills

Skill	Store
ccskill-nanobanana	~/.ccskill-nanobanana/gallery/
ccskill-omniflash	~/.ccskill-omniflash/gallery/
ccskill-gptimage	~/.ccskill-gptimage/gallery/

Any other skill that follows docs/store-spec.md is picked up automatically — there is nothing to configure.

Configuration

Optional file: ~/.ccskill-gallery/config.json

{
  "port": 8770,
  "bind": "127.0.0.1",
  "sources": {
    "exclude": ["somename"],
    "extra": [ { "name": "archive", "path": "~/media/old-gallery" } ]
  }
}

All keys are optional; the file itself is never created automatically. Precedence: CLI flags > config.json > defaults. sources.exclude hides an auto-discovered store by name; sources.extra adds stores outside the ~/.ccskill-*/gallery convention.

Troubleshooting

Run ccskill-gallery doctor first. Common issues:

Symptom	Fix
command not found: ccskill-gallery	cd <repo> && ./install.sh, ensure ~/.local/bin is in PATH
port already in use	ccskill-gallery browse --port 9000
a skill's gallery isn't showing up	run ccskill-gallery sources; check CCSKILL_<NAME>_GALLERY_DIR and ~/.ccskill-gallery/config.json
gallery is empty right after installing a skill	that skill hasn't generated anything yet