Claude Skill MartBrowse skillsQuick linesLearn by videoTerminal guideWhat is a Skill?
Back to list

asdf Version Manager Helper

A skill that guides asdf (asdf-vm) installation, plugin management, .tool-versions workflows, and shim troubleshooting.

Dev & CodingIntermediate13316AI score 9/10Last updated: Apr 20, 2026

What it does

  • Walks through installing asdf and wiring up shell integration for Bash, Zsh, and Fish (including completions).
  • Collects the essential commands: asdf plugin add, asdf install, asdf set (the modern replacement for local/global since v0.15+).
  • Explains .tool-versions syntax and version resolution order (cwd → parent dirs → $HOMEASDF_${TOOL}_VERSION), plus .asdfrc options.
  • Covers migration from nvm, pyenv, rbenv, goenv, tfenv via legacy_version_file with a legacy-file mapping table.
  • Provides troubleshooting recipes for shims, command not found, PATH ordering, and plugin build dependencies.

Who it's for

  • Developers consolidating multiple language version managers into one tool.
  • DevOps/cloud engineers pinning Terraform, kubectl, Helm, and gcloud versions per project.
  • Teams onboarding new members into repos that rely on .tool-versions for reproducible environments.

Example uses

  1. "Set up asdf on a fresh machine with Fish shell" → dependencies, clone, config.fish entry, completion symlink.
  2. "Match this repo's .tool-versions" → add the needed plugins, run asdf install, verify with asdf current.
  3. "node keeps resolving to the wrong version" → inspect asdf current, check PATH, run asdf reshim.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/jjmartres/opencode/HEAD/opencode/skills/asdf/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the opencode/skills/asdf folder from the GitHub repo jjmartres/opencode into my ~/.claude/skills/asdf/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/jjmartres/opencode.git /tmp/opencode && mkdir -p ~/.claude/skills && cp -r /tmp/opencode/opencode/skills/asdf ~/.claude/skills/

This is a third-party skill. Check the source repository before installing.

  1. Open a terminal.
  2. Create the skills directory if needed: mkdir -p ~/.claude/skills
  3. Clone the repo to a temp folder: git clone https://github.com/jjmartres/opencode.git /tmp/opencode
  4. Copy just this skill: cp -r /tmp/opencode/opencode/skills/asdf ~/.claude/skills/
  5. Confirm the file exists: ls ~/.claude/skills/asdf/SKILL.md
  6. Restart Claude Code and try a prompt like "use asdf to pin Node 20 for this project".
  7. Clean up: rm -rf /tmp/opencode