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 | | 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.

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 for their generous open-source contributions to the TYPO3 community, which helped shape this skill collection. Adapted by webconsulting.at for this skill collection