cli-tools

# 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 1. **Diagnose**: `which <tool>`, `command -v <tool>`, `type -a <tool>` 2. **Map binary**: Check `references/binary_to_tool_map.md` (`rg`->`ripgrep`, `ansible`->`ansible-core`, `batcat`->`bat`) 3. **Install**: `scripts/install_tool.sh <tool> install` 4. **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 | | 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 | --- ## Credits & Attribution This skill is based on the excellent work by **[Netresearch DTT GmbH](https://www.netresearch.de/)**. Original repository: https://github.com/netresearch/cli-tools-skill **Copyright (c) Netresearch DTT GmbH** — Methodology and best practices (MIT / CC-BY-SA-4.0) Special thanks to [Netresearch DTT GmbH](https://www.netresearch.de/) for their generous open-source contributions to the TYPO3 community, which helped shape this skill collection. Adapted by webconsulting.at for this skill collection