ruisi-lu/proto-skill/proto

Claude Code and agent skill by ruisi-lu/proto-skill

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Guide for proto — the pluggable multi-language version manager by moonrepo. Use when installing tools, pinning versions, configuring .prototools, writing plugins, or troubleshooting version detection.

Install

npx vskill@latest install ruisi-lu/proto-skill/proto

SKILL.md

proto

Always check [moonrepo.dev/docs/proto](https://moonrepo.dev/docs/proto) for the latest API. This skill targets proto v0.62; run proto --version and proto <command> --help when behavior differs.

proto is a pluggable, multi-language version manager (toolchain) built in Rust. It manages versions of programming languages and tooling (Node.js, Bun, Go, Python, Rust, Deno, …) via a single CLI, using a .prototools TOML config file for per-directory version pinning.

References

When to Use

SituationAction
Install / upgrade a language or toolproto install <tool> [version]
Pin a version for a projectproto pin <tool> <version>
Check for outdated toolsproto outdated
Set up shell activationproto activate <shell>
Run a one-off command with toolsproto exec node@22 -- node -v
Add a custom tool via pluginproto plugin add <id> <locator> or [plugins.tools]
Diagnose a broken setupproto diagnose / proto debug env
Create a new pluginUse the non-WASM schema or WASM
Detect why wrong version is runningSee version detection order

Quick Reference

Install proto itself
powershell
# Windows (PowerShell admin)
irm https://moonrepo.dev/install/proto.ps1 | iex
bash
# macOS / Linux / WSL
bash <(curl -fsSL https://moonrepo.dev/install/proto.sh)
Common commands
bash
proto install node          # Install latest Node.js
proto install node 22       # Install specific version
proto install               # Install all tools in .prototools
proto install node --pin    # Install and pin (install no longer auto-pins)
 
proto pin node 22 --resolve # Pin resolved version locally
proto pin node 22 --to global
 
proto outdated              # Check for newer versions
proto outdated --update     # Bump pinned versions in .prototools
proto upgrade               # Upgrade proto itself
proto status                # Show configured tools and install status
 
proto run node -- --version # Run a tool (or just use shim: node --version)
proto versions node         # List available versions (--installed for local)
proto uninstall node 20     # Remove a specific version
Minimal .prototools
toml
node = "22"
npm = "10"
go = "~1.22"
rust = "stable"
 
[settings]
auto-install = true
pin-latest = "local"
Shell activation (recommended over shims)
bash
# Add to end of ~/.zshrc / ~/.bashrc
eval "$(proto activate bash)"   # bash
eval "$(proto activate zsh)"    # zsh
proto activate fish | source    # fish
powershell
# Add to $PROFILE
proto activate pwsh | Out-String | Invoke-Expression
Running proto from an AI agent

proto detects agent environments and prints NDJSON (logs to stderr). Force a format with --reporter text|json|ndjson, and pass --yes to skip prompts. proto mcp exposes proto as an MCP server.

Version Detection Order

proto resolves versions in this order (first match wins):

  1. Explicit CLI argument: proto run node 22.0.0
  2. Environment variable: PROTO_NODE_VERSION=22.0.0
  3. .prototools (traversing up from cwd)
  4. Tool-native files (.nvmrc, package.json#devEngines, etc.)
  5. Global pin at ~/.proto/.prototools

Key Paths

PathPurpose
~/.proto/proto home directory ($PROTO_HOME)
~/.proto/tools/<tool>/<version>/Installed tool binaries
~/.proto/shims/Shim wrappers (added to PATH)
~/.proto/bin/Symlinks for pinned tools
~/.proto/.prototoolsGlobal version pins
./.prototoolsProject-local version pins
~/.prototoolsUser-level config

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

7-day trend score
5

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/ruisi-lu/proto-skill/proto/badge)](https://verified-skill.com/skills/ruisi-lu/proto-skill/proto)

Something wrong with this skill or its page? Tell us.