skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
thebushidocollective/han62 installs

mise-tool-management

Use when managing development tool versions with Mise. Covers installing tools, version pinning, and replacing language-specific version managers.

How do I install this agent skill?

npx skills add https://github.com/thebushidocollective/han --skill mise-tool-management
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill facilitates development tool management using the Mise version manager. It allows for the installation of software from trusted registries (npm, cargo, go) and Git repositories, and supports post-installation shell scripts. The primary security consideration is the indirect prompt injection surface created by the skill's instructions to read and execute configuration from local project files (e.g., mise.toml, .tool-versions), which could be controlled by an external actor in a repository.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerpass

    1/1 file flagged

What does this agent skill do?

Mise - Tool Management

Managing development tool versions across projects with Mise as a unified version manager.

Basic Tool Installation

Installing Tools

# Install specific version
mise install node@20.10.0
mise install python@3.12.0
mise install rust@1.75.0

# Install latest version
mise install node@latest
mise install python@latest

# Install from .tool-versions or mise.toml
mise install

Setting Tool Versions

# Set global version
mise use --global node@20

# Set project version
mise use node@20.10.0
mise use python@3.12 rust@1.75

# Use latest
mise use node@latest

Tool Configuration in mise.toml

Basic Tool Definitions

# mise.toml
[tools]
node = "20.10.0"
python = "3.12.0"
rust = "1.75.0"
terraform = "1.6.0"

Version Prefixes

[tools]
# Latest patch version
node = "20.10"

# Latest minor version
node = "20"

# Latest version
node = "latest"

# Prefix notation
terraform = "1.6"  # Latest 1.6.x

Multiple Versions

[tools]
# Use multiple versions
node = ["20.10.0", "18.19.0"]
python = ["3.12", "3.11", "3.10"]
# Switch between versions
mise shell node@18.19.0

Tool-Specific Configuration

Node.js Configuration

[tools]
node = { version = "20.10.0", postinstall = "corepack enable" }

Python with Virtual Environments

[tools]
python = "3.12"

[env]
_.python.venv = { path = ".venv", create = true }

Custom Tool Sources

[tools]
# From specific registry
"cargo:eza" = "latest"
"npm:typescript" = "5.3"

# From git repository
my-tool = "git:https://github.com/org/tool.git"

Supported Languages & Tools

Core Tools

[tools]
# Languages
bun = "1.0"
deno = "1.38"
elixir = "1.15"
erlang = "26.1"
go = "1.21"
java = "21"
node = "20.10"
python = "3.12"
ruby = "3.3"
rust = "1.75"
zig = "0.11"

# Infrastructure
terraform = "1.6"
kubectl = "1.28"
awscli = "2.13"

Package Managers

[tools]
"npm:pnpm" = "8.10"
"npm:yarn" = "4.0"
"cargo:cargo-binstall" = "latest"
"go:github.com/golangci/golangci-lint/cmd/golangci-lint" = "latest"

Tool Version Strategies

Lock to Specific Versions

# Production: Pin exact versions
[tools]
node = "20.10.0"
terraform = "1.6.4"

Use Ranges for Flexibility

# Development: Use minor version ranges
[tools]
node = "20"      # Any 20.x
python = "3.12"  # Any 3.12.x

Latest for Experimentation

# Experimental projects
[tools]
rust = "latest"
bun = "latest"

Managing Tool Aliases

Creating Aliases

# Set alias for current directory
mise alias set node lts 20.10.0

# Set global alias
mise alias set --global python3 python@3.12

Using Aliases in Configuration

[tools]
node = "lts"
python = "3.12"

Tool Verification

Check Installed Tools

# List installed tools
mise list

# Check current versions
mise current

# Verify tool installation
mise doctor

Tool Information

# Show tool details
mise ls-remote node

# List available versions
mise ls-remote python

# Check latest version
mise latest node

Migration from Other Version Managers

From asdf

# Mise reads .tool-versions files
cat .tool-versions
# nodejs 20.10.0
# python 3.12.0

# Migrate to mise.toml
mise use node@20.10.0 python@3.12.0

From nvm

# Read from .nvmrc
cat .nvmrc
# 20.10.0

mise use node@$(cat .nvmrc)

From pyenv

# Read from .python-version
mise use python@$(cat .python-version)

Best Practices

Pin Production Dependencies

# Good: Explicit production versions
[tools]
node = "20.10.0"
terraform = "1.6.4"
postgres = "16.1"

Document Required Tools

# mise.toml - All project dependencies in one place
[tools]
node = "20.10.0"
python = "3.12.0"
terraform = "1.6.4"
kubectl = "1.28.0"

[env]
PROJECT_NAME = "my-app"

Use Tool-Specific Settings

[tools]
# Enable corepack for package managers
node = { version = "20.10.0", postinstall = "corepack enable" }

# Create Python virtual environment
python = { version = "3.12", venv = ".venv" }

Verify Tool Installation

# In CI/CD pipelines
mise install --check
mise doctor

# Verify specific tools
mise current node
mise current python

Common Patterns

Monorepo Tool Management

# Root mise.toml - shared tools
[tools]
node = "20.10.0"
terraform = "1.6.4"

# packages/api/mise.toml - additional tools
[tools]
"npm:typescript" = "5.3"
"npm:prisma" = "5.7"

# packages/web/mise.toml
[tools]
"npm:next" = "14.0"

Development vs Production

# mise.toml - production tools
[tools]
node = "20.10.0"
postgres = "16.1"

# mise.local.toml - development tools (gitignored)
[tools]
"npm:nodemon" = "latest"
"cargo:cargo-watch" = "latest"

Tool Updates Strategy

# Check for updates
mise outdated

# Update to latest patch version
mise upgrade node

# Update all tools
mise upgrade

# Update with constraints
mise use node@20  # Updates to latest 20.x

Anti-Patterns

Don't Mix Version Managers

# Bad: Using multiple version managers
nvm use 20
mise use node@20  # Conflicts

# Good: Use only Mise
mise use node@20

Don't Hardcode Tool Paths

# Bad: Hardcoded paths
/Users/me/.local/share/mise/installs/node/20.10.0/bin/node

# Good: Use mise shims or mise exec
mise exec -- node
mise x -- node

Don't Skip Version Constraints

# Bad: No version specified
[tools]
node = "latest"  # Can break on updates

# Good: Specify constraints
[tools]
node = "20.10.0"  # Explicit
# OR
node = "20"  # Controlled range

Don't Ignore Tool Dependencies

# Bad: Missing required tools
[tools]
terraform = "1.6"
# Missing: kubectl, helm for deployment

# Good: Include all dependencies
[tools]
terraform = "1.6.4"
kubectl = "1.28.0"
helm = "3.13.0"

Advanced Patterns

Conditional Tool Installation

[tools]
# Install based on platform
node = "20.10.0"
python = "3.12"

# Platform-specific tools
[tools."cargo:watchexec-cli"]
platforms = ["linux", "darwin"]
version = "latest"

Tool Installation Hooks

[tools]
node = {
  version = "20.10.0",
  postinstall = '''
    corepack enable
    npm install -g npm@latest
  '''
}

Backend Selection

# Use specific backend for tools
[tools]
# Use core backend (faster)
node = "core:20.10.0"

# Use asdf plugin
ruby = "asdf:3.3.0"

Related Skills

  • task-configuration: Defining tasks that use managed tools
  • environment-management: Managing environment variables with tools

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/thebushidocollective/han/mise-tool-management">View mise-tool-management on skillZs</a>