Command-line tools
Pick the tool for the task, then read its reference for the flags, the rules and the output. When a tool is missing, say so and use its fallback. When the fallback is none, tell the user which tool to install and do not improvise one.
| Task | Tool | Reference | Fallback |
|---|---|---|---|
| Search text in files | rg |
ripgrep | grep -rn |
| Find files by name or type | fd |
fd | find |
| Read or reshape JSON | jq |
jq | a script |
| Read or reshape YAML or TOML | yq |
yq | a script |
| Replace text in files | sd |
sd | sed |
| Search or rewrite code structure | ast-grep |
ast-grep | rg |
| Call an HTTP API | xh, curl |
xh, curl | curl |
| Download a file | curl -O |
curl | none |
| Read a diff | delta |
git-delta | git diff |
| Run a project recipe | just |
just | the README command |
| Run with the project variables | direnv exec . |
direnv | set them by hand |
| Large binary files in git | git lfs |
git-lfs | none |
| Check a shell script | shellcheck |
shellcheck | none |
| Find spelling mistakes | typos |
typos | none |
| Git commands | git |
git | none |
| Review and stage by hand | lazygit |
lazygit | git |
| Pick a line from a list | fzf |
fzf | rg |
| Python projects and scripts | uv |
uv | pip |
To give every repo on this machine this skill and its references, run basicly skills-user cli-tools. Run it again after each upgrade, because a stale personal copy hides the project skill.
Rules
- Never start an interactive tool.
fzf,lazygit,tmuxandweztermwait for a person; use only the forms their references mark as safe.