skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
oakoss/agent-skills94 installs

ghostty

Controls the Ghostty terminal emulator via CLI actions and configuration. Use when managing Ghostty windows, fonts, themes, keybinds, config validation, or debugging terminal configuration. Use for ghostty CLI, terminal config, theme selection, font management.

How do I install this agent skill?

npx skills add https://github.com/oakoss/agent-skills --skill ghostty
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill provides comprehensive documentation and usage instructions for the Ghostty terminal emulator, covering CLI actions, configuration management, and keybind settings. It is purely informational and does not contain any malicious code or instructions.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerwarn

    3/3 files flagged

What does this agent skill do?

Ghostty Skill

Overview

Ghostty is a fast, feature-rich, cross-platform terminal emulator that uses platform-native UI and GPU acceleration. It provides a CLI with +action commands for querying configuration, listing themes/fonts, validating config, and opening new windows via IPC. Window, tab, and split management are handled through keybind actions configured in the config file, not through CLI commands.

When to use: Configuring Ghostty themes, fonts, and keybinds; validating config files; querying available actions and themes; opening new windows from scripts; debugging terminal rendering issues.

When NOT to use: Managing other terminal emulators; tasks unrelated to terminal configuration.

Quick Reference

TaskCommand / ConfigKey Points
List CLI actionsghostty +list-actionsShows keybind actions, not CLI actions
List themesghostty +list-themesInteractive TUI preview; --color=dark to filter
List fontsghostty +list-fontsUses Ghostty's font discovery
List keybindsghostty +list-keybindsAdd --default for defaults only
List colorsghostty +list-colorsNamed RGB colors available in config
Show configghostty +show-configAdd --default --docs for all options
Validate configghostty +validate-configCheck config file for errors
Edit configghostty +edit-configOpens config in $VISUAL or $EDITOR
New window (IPC)ghostty +new-windowLinux/GTK only via D-Bus; use -e for command
Run commandghostty -e htopArguments after -e are the command
Set working dirghostty --working-directory=/pathChanges directory before running command
Custom configghostty --config-file=/pathLoad additional config file
Check versionghostty --versionDisplay version info
SSH terminfoghostty +ssh-cacheManage SSH terminfo cache for remote hosts
Show font faceghostty +show-face <codepoint>Which font renders a specific Unicode codepoint
Crash reportsghostty +crash-reportInspect and manage crash reports

Common Mistakes

MistakeCorrect Pattern
Running ghostty +new-tab or +new-split as CLI commandsThese are keybind actions, not CLI actions; configure them in the config file with keybind = ...
Running ghostty without full path when not symlinked on macOSUse /Applications/Ghostty.app/Contents/MacOS/ghostty or create a symlink
Using +new-window on macOS expecting it to work+new-window uses D-Bus IPC and only works on Linux/GTK
Editing config without reloadingUse the reload_config keybind action (default: ctrl+shift+comma on Linux)
Using --config-file with a relative pathUse absolute paths for --config-file to avoid resolution issues
Passing unknown actions without checking available listRun ghostty +help to see CLI actions or +list-actions for keybind actions
Confusing CLI actions with keybind actionsCLI actions use +action syntax; keybind actions are configured via keybind = key=action in config

Delegation

  • Discover available actions and themes: Use Explore agent to run ghostty +list-actions and ghostty +list-themes
  • Automate terminal layouts: Use Task agent to script window creation and config changes
  • Plan configuration changes: Use Plan agent to design keybind and theme configurations before applying

References

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/oakoss/agent-skills/ghostty">View ghostty on skillZs</a>