ruby-cli
Build Ruby CLI tools with Thor and Zeitwerk. Use for new Ruby CLI gems, adding commands, refactoring, or 'Thor CLI', 'command-line tool in Ruby'.
How do I install this agent skill?
npx skills add https://github.com/steveclarke/dotfiles --skill ruby-cliIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides templates and best practices for building Ruby command-line interfaces using Thor for command management, Zeitwerk for code loading, and Gum for terminal UI. The analysis confirms the skill follows standard development workflows and uses reputable libraries. No security issues were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
4/4 files flagged
What does this agent skill do?
Ruby CLI Development
Build Ruby CLI tools using Thor for commands and Zeitwerk for autoloading.
Quick Navigation
- Starting a new CLI gem from scratch? See references/bootstrap.md
- Adding commands or subcommands? See references/patterns.md
- Thor syntax reference? See references/patterns.md
- Rich terminal UI with Gum? See references/gum.md
Core Principles
- Use compact class declarations:
class GemName::Cli::Main < GemName::Cli::Base - Use
extend selfinstead ofmodule_functionfor utility modules - Keep the Base class lean - add helpers as patterns emerge
Output Styling
For basic output, use Thor's built-in say "message", :color.
For rich terminal UI (headers, tables, spinners, confirmations), use the Gum gem:
ui.header("Section Title") # branded header with border
ui.success("Done!") # green checkmark
ui.error("Failed") # red X
ui.table(rows, columns: [...]) # formatted table
ui.spin("Working...") { ... } # spinner during work
See references/gum.md for setup and full API.
Tips & Gotchas
- Add
# rubocop:disable Rails/Outputto UI modules (stdout is intentional in CLIs) - The gum gem bundles the gum binary for common platforms;
GUM_INSTALL_DIRpoints it at a system install elsewhere
How can the creator link this skill?
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/steveclarke/dotfiles/ruby-cli">View ruby-cli on skillZs</a>