mcpField
C
cli-tools

cli-tools

github.com/netresearchDevelopment684 installsUpdated 7w ago
Repository

About cli-tools

cli-tools is an agent skill for installing, auditing, updating, and recommending command-line tools. It combines a catalog with diagnostic scripts and project-specific requirements.

Key features

  1. 01Install, update, uninstall, and check tool status
  2. 02Diagnose missing commands
  3. 03Audit environment and PATH
  4. 04Detect project type and tool needs
  5. 05Recommend modern command-line alternatives

Use cases

  1. 01Resolve a command not found error
  2. 02Audit tools needed for a project
  3. 03Update tools across package managers

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/netresearch/cli-tools-skill --skill cli-tools

After installing, type/cli-toolsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
binary_to_tool_map.md
preferred-tools.md
project_type_requirements.md
resolution-workflow.md
troubleshooting.md
scripts/
auto_update.sh
check_environment.sh
detect_project_type.sh
install_composer.sh
install_tool.sh
scripts/installers/
aws_installer.sh
dedicated_script.sh
github_clone.sh
github_release_binary.sh
hashicorp_zip.sh
npm_global.sh
npm_self_update.sh
package_manager.sh
uv_tool.sh
scripts/lib/
capability.sh
catalog.sh
common.sh
dependency.sh
install_strategy.sh
path_check.sh
policy.sh
reconcile.sh
root.sh
scope_detection.sh

Details

From the project README

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.

LegacyModernLegacyModern
grep -rrgdiffdifft
findfdtimehyperfine
grep on JSONjqcatbat
sed on YAMLyqcloctokei/scc
awk on CSVqsvgrep for secsemgrep
sed on TOMLdasel

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

SymptomFix
Installed but not foundhash -r or add dir to PATH
No sudocargo install, pip install --user, manual binary; on Debian/Ubuntu apt-get download + dpkg -x
Debian bat=batcat, fd=fdfindSymlink to ~/.local/bin/

See references/troubleshooting.md for Docker fallbacks and permission workarounds.

Scripts

ScriptPurpose
scripts/install_tool.shInstall/update/uninstall/status
scripts/auto_update.shBatch update package managers
scripts/check_environment.shAudit environment and PATH
scripts/detect_project_type.shDetect project type

References

FilePurpose
references/binary_to_tool_map.mdBinary-to-catalog mapping
references/project_type_requirements.mdTools per project type
references/preferred-tools.mdModern tool usage patterns
references/resolution-workflow.mdDiagnostic/install/verify flow
references/troubleshooting.mdPATH, permissions, fallbacks

Comments

Markdown supported