| name | cli-tools |
| description | Use when ANY command fails with 'command not found', when installing CLI tools (ripgrep, fd, jq, yq, bat, etc.), auditing project environments, or batch-updating tools. Triggers on: command not found, install tool, missing binary, environment audit, update tools, which, apt install, brew install. |
| license | (MIT AND CC-BY-SA-4.0) |
| compatibility | Requires bash, common package managers. |
| metadata | {"version":"1.9.1","repository":"https://github.com/netresearch/cli-tools-skill","author":"Netresearch DTT GmbH"} |
| allowed-tools | ["Bash(apt:*)","Bash(brew:*)","Bash(npm:*)","Bash(pip:*)","Read","Write"] |
CLI Tools Skill
Install, audit, update, and recommend CLI tools across 77 cataloged entries.
Triggers
- Reactive:
command not found errors -- auto-resolve
- Proactive: "check environment", "install X", "update tools"
- Advisory: Recommend modern alternatives (
grep->rg, find->fd, JSON->jq)
Preferred Modern Tools
Recommend over legacy equivalents. See references/preferred-tools.md for examples.
| Legacy | Modern | Legacy | Modern |
|---|
grep -r | rg | diff | difft |
find | fd | time | hyperfine |
| grep on JSON | jq | cat | bat |
| sed on YAML | yq | cloc | tokei/scc |
| awk on CSV | qsv | grep for sec | semgrep |
| sed on TOML | dasel | | |
Workflows
Missing Tool Resolution
- Diagnose:
which <tool>, command -v <tool>, type -a <tool>
- Map binary: Check
references/binary_to_tool_map.md (rg->ripgrep, ansible->ansible-core, batcat->bat)
- Install:
scripts/install_tool.sh <tool> install
- Verify:
which <tool> + <tool> --version; if still missing: hash -r, check PATH
See references/resolution-workflow.md for full diagnostic steps.
Environment Audit
Run scripts/check_environment.sh audit . and scripts/detect_project_type.sh, then cross-reference with references/project_type_requirements.md for per-type tool lists.
Batch Update
scripts/auto_update.sh (all managers) or scripts/install_tool.sh <tool> update (single).
Troubleshooting
| Symptom | Fix |
|---|
| Installed but not found | hash -r or add dir to PATH |
| No sudo | cargo install, pip install --user, manual binary; on Debian/Ubuntu apt-get download + dpkg -x |
Debian bat=batcat, fd=fdfind | Symlink to ~/.local/bin/ |
See references/troubleshooting.md for Docker fallbacks and permission workarounds.
Scripts
| Script | Purpose |
|---|
scripts/install_tool.sh | Install/update/uninstall/status |
scripts/auto_update.sh | Batch update package managers |
scripts/check_environment.sh | Audit environment and PATH |
scripts/detect_project_type.sh | Detect project type |
References
| File | Purpose |
|---|
references/binary_to_tool_map.md | Binary-to-catalog mapping |
references/project_type_requirements.md | Tools per project type |
references/preferred-tools.md | Modern tool usage patterns |
references/resolution-workflow.md | Diagnostic/install/verify flow |
references/troubleshooting.md | PATH, permissions, fallbacks |
