https://github.com/netresearch/cli-tools-skill
Agent Skill for automatic CLI tool management - installs missing tools, audits environments | Claude Code compatible
https://github.com/netresearch/cli-tools-skill
agent-skills ai-agent automation claude-code-skill cli developer-tools open-standard package-manager skill
Last synced: 25 days ago
JSON representation
Agent Skill for automatic CLI tool management - installs missing tools, audits environments | Claude Code compatible
- Host: GitHub
- URL: https://github.com/netresearch/cli-tools-skill
- Owner: netresearch
- License: other
- Created: 2025-11-29T21:10:49.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-04-01T10:39:45.000Z (26 days ago)
- Last Synced: 2026-04-01T11:15:47.132Z (26 days ago)
- Topics: agent-skills, ai-agent, automation, claude-code-skill, cli, developer-tools, open-standard, package-manager, skill
- Language: Shell
- Homepage:
- Size: 164 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE-CC-BY-SA-4.0
- Agents: AGENTS.md
Awesome Lists containing this project
README
# 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](https://agentskills.io) 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
### Marketplace (Recommended)
Add the [Netresearch marketplace](https://github.com/netresearch/claude-code-marketplace) once, then browse and install skills:
```bash
# Claude Code
/plugin marketplace add netresearch/claude-code-marketplace
```
### npx ([skills.sh](https://skills.sh))
Install with any [Agent Skills](https://agentskills.io)-compatible agent:
```bash
npx skills add https://github.com/netresearch/cli-tools-skill --skill cli-tools
```
### Download Release
Download the [latest release](https://github.com/netresearch/cli-tools-skill/releases/latest) and extract to your agent's skills directory.
### Git Clone
```bash
git clone https://github.com/netresearch/cli-tools-skill.git
```
### Composer (PHP Projects)
```bash
composer require netresearch/cli-tools-skill
```
Requires [netresearch/composer-agent-skill-plugin](https://github.com/netresearch/composer-agent-skill-plugin).
## Triggers
The skill activates automatically on:
### Error Patterns
```
bash: : command not found
zsh: command not found:
'' 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
This project uses split licensing:
- **Code** (scripts, workflows, configs): [MIT](LICENSE-MIT)
- **Content** (skill definitions, documentation, references): [CC-BY-SA-4.0](LICENSE-CC-BY-SA-4.0)
See the individual license files for full terms.
## Contributing
1. Add tool definition to `catalog/.json`
2. Update `references/binary_to_tool_map.md` if binary differs from tool name
3. Test with `scripts/install_tool.sh install`
4. Submit PR
## Credits
Developed and maintained by [Netresearch DTT GmbH](https://www.netresearch.de/).
---
**Made with ❤️ for Open Source by [Netresearch](https://www.netresearch.de/)**