cli
CLI Router
Route the task to the narrowest tool that matches the job. Keep this file small; read references/ only for the tool you need.
Choose The Tool
| Tool | Use it for | Avoid when | Reference |
|---|---|---|---|
fd |
Fast file and path discovery | You need content matches inside files | references/fd.md |
rg |
Fast text search across files | You need structural or syntax-aware matching | references/ripgrep.md |
sd |
Simple literal or regex replacement | The change depends on code structure or multiline context beyond regex comfort | references/sd.md |
comby |
Lightweight structural rewrites across languages | You need full syntax parsing guarantees | references/comby.md |
ast-grep |
AST-aware code search, lint, and rewrite | You need type-aware or semantic analysis | references/ast-grep.md |
jq |
Query and transform JSON | The source is YAML-first | references/jq.md |
yq |
Query and edit YAML, convert structured formats | You need exact comment preservation or full jq parity assumptions |
references/yq.md |
wget |
Non-interactive download, retry, resume, mirror | You need browser automation or interactive login flows | references/wget.md |
head |
Quick non-interactive sampling | You need interactive search, paging, or follow mode | references/head.md |
less |
Interactive paging, search, and follow | The flow must stay unattended | references/less.md |
fzf |
Interactive fuzzy selection for humans | The agent must run headless or deterministically | references/fzf.md |
difftastic |
Syntax-aware diffs for human review | You need an applicable patch or machine-stable diff format | references/difftastic.md |
shellcheck |
Shell linting and safety checks | You need formatting rather than diagnostics | references/shellcheck.md |
scc |
Repo language inventory, LOC, and rough complexity | You need semantic code review or profiling | references/scc.md |
Escalate Deliberately
- Use
fdfor paths, thenrgfor text. - Use
sdfor simple replacements,combywhen regex gets brittle, andast-grepwhen syntax precision matters. - Use
jqfor JSON andyqfor YAML-first edits or format conversion. - Use
headfor quick samples; switch tolessonly when a human needs to page or search. - Treat
fzf,less, anddifftasticas human-oriented tools unless the task explicitly benefits from interactive review.
Load More Detail Only When Needed
- Read
references/api-surface.mdfor command/flag selection across the toolset. - Read
references/common-use-cases.mdfor ready-made task patterns. - Read
references/troubleshooting-workarounds.mdfor common failure modes. - Read the tool-specific reference for examples, sharp edges, and escalation boundaries.
More from aaronflorey/agent-skills
amber-lang
Write, debug, and explain Amber code, the `amber` language that compiles `.ab` files to Bash. Use this skill when the user asks to write an Amber script, convert Bash to Amber, compile Amber to Bash, debug Amber syntax or type errors, or asks about Amber 0.5.1-alpha syntax, functions, types, error handling, the standard library, or the `amber` CLI.
26go-cobra
Write, scaffold, and debug Go CLI applications with `github.com/spf13/cobra`. Use this skill whenever the user mentions Cobra, `cobra.Command`, a Go command-line app, subcommands, persistent or local flags, required flags, argument validation, shell completions, generated docs, or wants to build or refactor a cobra-based CLI.
24laravel-actions
Write, scaffold, explain, and refactor code using the `lorisleiva/laravel-actions` package. Use this skill whenever the user mentions Laravel Actions, `AsAction`, `php artisan make:action`, action classes, converting a controller, job, listener, or command into an action, dispatching an action as a job, using an action as a controller or listener, or adding validation, authorization, testing, or mocking around an action.
24num30-config
Write, debug, and explain Go configuration code using `github.com/num30/config`. Use this skill when the user mentions `num30/config`, wants config structs, file plus env plus CLI flag loading, validation, config watching, precedence rules, or asks how to integrate the num30/config package into a Go application.
22pelican-panel-plugins
Write, scaffold, explain, and debug plugins for the Pelican gaming panel. Use this skill whenever the user mentions Pelican plugins, extending Pelican, FilamentPHP resources or pages for Pelican, plugin service providers, custom permissions, plugin settings, routes, models, widgets, or asks how to add new functionality to the Pelican panel.
21go-viper
Write, debug, and explain Go configuration code with `github.com/spf13/viper`. Use this skill whenever the user mentions Viper, `viper`, config structs, reading config from files plus env vars plus flags, Cobra or `pflag` integration, unmarshaling into structs, env key replacers, config precedence, config watching, or a clean Viper bootstrap.
20