Agent-Skills.md

Agent Skills: CLI Tools Skill

Agent Skill: CLI tool management. Use when commands fail with 'command not found', installing tools, or checking project environments. By Netresearch.

UncategorizedID: questnova502/claude-skills-sync/cli-tools

Repository

questnova502/claude-skills-sync
QuestNova502
34

Install this agent skill to your local

pnpm dlx add-skill https://github.com/QuestNova502/claude-skills-sync/tree/HEAD/skills/cli-tools/skills/cli-tools

Skill Files

Browse the full folder contents for cli-tools.

Download Skill

Loading file tree…

skills/cli-tools/skills/cli-tools/SKILL.md

Skill Metadata

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

CLI Tools Skill

Install, audit, update, and recommend CLI tools across 74 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 |