| 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
ccskill-gallery browse --port 9000
ccskill-gallery browse --bind 0.0.0.0
ccskill-gallery browse --no-open
ccskill-gallery serve
ccskill-gallery sources
ccskill-gallery doctor
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 |
