optional-skills/show-image/SKILL.md
Show images in terminal using the Kitty image protocol. TRIGGER when show/view images in terminal, display plot results.
npx skillsauth add archibate/dotfiles-opencode show-imageInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
You are a CLI assistant running in terminal, potentially over SSH connections. You have no access to X display.
This skill provides a handy scripts/show_image.py tool to display image in user Kitty terminal thanks to the Kitty image protocol.
scripts/show_image.py /path/to/image.png
Use this skill when:
Assistant: I've executed a plot script, plot result saved to /path/to/image.png.
User: please show me that image.
Assistant: Use show-image skill -> Run scripts/show_image.py /path/to/image.png -> Image appear in user terminal.
The user is using the Kitty terminal, which has a support for the Kitty image protocol - allowing to display high resolution images directly in terminal. This works even over SSH remote connections.
When scripts/show_image.py is called with an image, it automatically creates a new Kitty pane (if not created yet), running a show-image server, to constantly listen to all scripts/show_image.py calls, and display the images being passed as arguments.
The created Kitty pane for image display will be reused for future scripts/show_image.py invocations.
New invocations to scripts/show_image.py will stacks up in the image pane. The user is able to scroll up to see previous shown images.
Images shown previously are not updated automatically, rerun scripts/show_image.py when image updated.
Assume user have installed and using Kitty with remote control enabled. If they didn't, the script will fail with a clear error message reported.
You are a CLI assistant running in OpenCode, which have rich TUI interface. If we show image directly in your running pane, the OpenCode TUI you live in would be severely interfered. Creating a new pane only for display prevents TUI being screwed up.
scripts/show_image.py wrapper for showing imagekitty +kitten icat image.png or display image.pngdevelopment
Color theme palettes for UI/UX design and personal configurations (i3wm, dunst, etc.). Use when user asks to apply color themes like Tokyo Night, needs color palettes for frontend development, or wants to customize terminal/desktop colors.
development
This skill should be used when the user asks about "code complexity", "cyclomatic complexity", "cognitive complexity", "code metrics", "maintainability index", "code coverage", or when measuring code quality quantitatively. Provides metrics thresholds and measurement techniques.
tools
Implement CLI tools in Python, JS/TS, Bash, or Go following clig.dev standards. Use when writing or reviewing CLI code.
tools
Spec CLI surface area before implementation - command tree, flags, exit codes, I/O contract. Use when designing or planning a CLI interface.