Skip to content

Agent Skill for automatic CLI tool management - installs missing tools, audits environments | Claude Code compatible

License

Notifications You must be signed in to change notification settings

netresearch/cli-tools-skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CLI Tools Skill

A Claude Code skill for automatic CLI tool management. Detects missing tools, installs them via optimal package managers, and audits project environments.

🔌 Compatibility

This is an Agent Skill following the open standard originally developed by Anthropic and released for cross-platform use.

Supported Platforms:

  • ✅ Claude Code (Anthropic)
  • ✅ Cursor
  • ✅ GitHub Copilot
  • ✅ Other skills-compatible AI agents

Skills are portable packages of procedural knowledge that work across any AI agent supporting the Agent Skills specification.

Features

  • Reactive Mode: Auto-detect "command not found" errors and install missing tools
  • Proactive Mode: Audit project environments and report missing/outdated tools
  • Maintenance Mode: Batch update all managed tools across package managers

Supported Tools

74+ tools across categories:

Category Tools
Core CLI ripgrep, fd, fzf, jq, yq, bat, delta, just
Languages python, node, rust, go, ruby, php
Package Managers uv, npm, pnpm, cargo, pip, gem, composer
DevOps docker, compose, kubectl, terraform, ansible
Linters eslint, prettier, ruff, black, shellcheck, phpstan
Security trivy, gitleaks, bandit, semgrep
Git Tools gh, glab, git-lfs, delta

Project Type Detection

Automatically detects project types and their requirements:

Project Type Detection Files Required Tools
Python pyproject.toml, requirements.txt python, uv
Node.js package.json node, npm
Rust Cargo.toml rust
Go go.mod go
PHP composer.json, *.php php, composer
Ruby Gemfile ruby
Docker Dockerfile, docker-compose.yml docker, compose
Terraform *.tf terraform

Installation

Option 1: Via Netresearch Marketplace (Recommended)

/plugin marketplace add netresearch/claude-code-marketplace

Then browse skills with /plugin.

Option 2: Download Release

Download the latest release and extract to ~/.claude/skills/cli-tools/

Option 3: Manual Installation

# Copy to your skills directory
cp -r cli-tools ~/.claude/skills/

Manual Usage

# Install a specific tool
./scripts/install_tool.sh ripgrep install

# Detect project type
./scripts/detect_project_type.sh json .

# Audit environment
./scripts/check_environment.sh audit .

# Update all tools
./scripts/auto_update.sh update

Triggers

The skill activates automatically on:

Error Patterns

bash: <tool>: command not found
zsh: command not found: <tool>
'<tool>' is not recognized as an internal or external command

User Requests

  • "check environment", "audit tools"
  • "what's missing", "what's outdated"
  • "install development tools"
  • "update all tools"

Installation Methods

The skill selects the optimal installation method based on catalog priority:

  1. GitHub Release Binary - Direct download (fastest, no deps)
  2. Cargo - Rust tools via cargo install
  3. UV/Pip - Python tools
  4. NPM - Node tools
  5. Apt/Brew - System packages (fallback)

Priority: user-level (~/.local/bin, ~/.cargo/bin) over system-level.

Directory Structure

cli-tools/
├── SKILL.md              # Skill definition and workflows
├── catalog/              # Tool definitions (74+ JSON files)
│   ├── ripgrep.json
│   ├── php.json
│   └── ...
├── scripts/
│   ├── install_tool.sh   # Main installer
│   ├── auto_update.sh    # Batch updater
│   ├── check_environment.sh
│   ├── detect_project_type.sh
│   ├── lib/              # Shared libraries
│   └── installers/       # Method-specific installers
└── references/
    ├── binary_to_tool_map.md
    └── project_type_requirements.md

Requirements

  • jq: Required for JSON parsing (auto-installed if missing)
  • Bash 4+: Required for associative arrays
  • Internet: Required for tool downloads

License

MIT License - See LICENSE for details.

Contributing

  1. Add tool definition to catalog/<tool>.json
  2. Update references/binary_to_tool_map.md if binary differs from tool name
  3. Test with scripts/install_tool.sh <tool> install
  4. Submit PR

Credits

Developed and maintained by Netresearch DTT GmbH.


Made with ❤️ for Open Source by Netresearch

About

Agent Skill for automatic CLI tool management - installs missing tools, audits environments | Claude Code compatible

Topics

Resources

License

Stars

Watchers

Forks

Languages