SKILL.md
CLI Tools Skill
Install, audit, update, and recommend CLI tools across 77 cataloged entries.
Triggers
- Reactive:
command not founderrors -- 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/binarytotool_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/checkenvironment.sh audit . and scripts/detectprojecttype.sh, then cross-reference with references/projecttype_requirements.md for per-type tool lists.
Batch Update
scripts/autoupdate.sh (all managers) or scripts/installtool.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/detectprojecttype.sh |
Detect project type |
References
| File | Purpose |
|---|---|
references/binarytotool_map.md |
Binary-to-catalog mapping |
references/projecttyperequirements.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