Asdf

Command reference for asdf-vm: plugins, .tool-versions, shims, and migrating off nvm/pyenv/rbenv.

Tested · Works

Test report

Verdict
Tested · Works
Score
8.4/10
Tested
Jul 14, 2026
Environment
Claude Code 2.x (agent harness)
Upstream re-checked
Aug 10, 2026 · 3014981

A migrate-from-nvm mini-task showed the concrete value: the skill body correctly reaches for the modern `asdf set` command and the exact `.asdfrc` `legacy_version_file` key plus `asdf reshim` for broken shims, where an unguided answer is more likely to reach for the deprecated `asdf local`/`asdf global` syntax still common in older docs.

Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works

  • Installs cleanly 5/5
  • Triggers reliably 5/5
  • Output vs. baseline 7/10
  • Docs & honesty 4/5

What Asdf does

Reference for installing and operating asdf, the universal runtime version manager, covering plugin management, .tool-versions resolution, shell integration for Bash/Zsh/Fish, shim troubleshooting, and migration from nvm/pyenv/rbenv/tfenv. Triggers on any mention of asdf, .tool-versions files, or switching between per-project language/tool versions.

How to install Asdf

git clone https://github.com/jjmartres/ai-coding-agents
cd ai-coding-agents
mkdir -p ~/.claude/skills
cp -r shared/.ai-agents/skills/asdf ~/.claude/skills/asdf

Skills live in ~/.claude/skills/ (global) or .claude/skills/ (per-project). Restart Claude Code after installing.

Commands — how to trigger Asdf

  • /asdf Command reference for asdf-vm: plugins, .tool-versions, shims, and migrating off nvm/pyenv/rbenv.

It also activates on plain-language prompts like these:

  • How do I install asdf and set up Node 20 with .tool-versions?
  • I'm migrating from nvm to asdf, how do I enable legacy files?
  • My asdf shims aren't working, node command not found

Frequently asked questions

Is the Asdf skill free?
Yes. The skill itself is free from jjmartres/ai-coding-agents. SkillProof publishes the install command and an independent test verdict at no cost.
Does Asdf work with Claude Code?
We tested it with Claude Code 2.x (agent harness) on Jul 14, 2026. Verdict: Tested · Works. A migrate-from-nvm mini-task showed the concrete value: the skill body correctly reaches for the modern `asdf set` command and the exact `.asdfrc` `legacy_version_file` key plus `asdf reshim` for broken shims, where an unguided answer is more likely to reach for the deprecated `asdf local`/`asdf global` syntax still common in older docs.
What is the Asdf SkillProof Score?
8.4/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 7/10, docs & honesty 4/5.
How do I install Asdf?
Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
Can I use Asdf with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.