Skip to main content
Alison Aquinas logoAlison's LLM Skills Marketplace

asdf

Included in skill bundleci-cdView on GitHub ↗

Files

SKILL.mdagentsreferences

Install

Install only this skill with npx skills
npx skills add alisonaquinas/llm-ci-dev --skill 'asdf' -g -y
Install the containing skill bundle
/plugin install ci-cd@llm-skills
Download asdf-skill.zip
This skill is bundled inside ci-cd. Use npx skills when you only want this skill, or install the bundle once to make every included skill available through the plugin marketplace flow. Browse the full skill bundle repository at github.com/alisonaquinas/llm-ci-dev.

Invoke

Invoke this skill after installation
/ci-cd:asdf

SKILL.md

name: asdf description: Manage multiple language runtime versions with asdf. Use when tasks mention asdf, .tool-versions, or managing multiple language runtimes with a single tool.

asdf

Intent Router

RequestReferenceLoad When
git clone install, Homebrew, shell integration, plugin overviewreferences/install-and-setup.mdasdf needs to be installed or the shell integration is missing
plugin add/install/global/local/current/list/reshim commandsreferences/command-cookbook.mdSpecific asdf commands are needed
Finding plugins, popular plugins, plugin lifecyclereferences/plugins-and-tools.mdAdding or managing plugins for a new language/tool is the topic
.tool-versions format, inheritance, CI usagereferences/tool-versions.mdProject-level version pinning or CI configuration is the topic

Quick Start

# Add the Node.js plugin and install a version
asdf plugin add nodejs
asdf install nodejs 20.14.0
asdf global nodejs 20.14.0

# Pin versions for a project (writes .tool-versions)
asdf local nodejs 20.14.0
asdf local python 3.12.3

# Check active versions
asdf current

Core Command Tracks

  • Add plugin: asdf plugin add <name>
  • Install version: asdf install <name> <version>
  • Global default: asdf global <name> <version>
  • Project pin: asdf local <name> <version> (writes .tool-versions)
  • Active versions: asdf current
  • List installed: asdf list <name>
  • Reshim binaries: asdf reshim <name>
# Troubleshoot missing binary after npm global install
npm install -g typescript
asdf reshim nodejs
which tsc   # should now resolve to the asdf shim

Safety Guardrails

  • Run asdf reshim <name> after installing packages that provide new CLI binaries (e.g. after npm install -g).
  • Commit .tool-versions to version control so all contributors and CI use the same runtime versions.
  • Keep plugins up to date with asdf plugin update --all periodically.
  • Prefer asdf local over editing .tool-versions by hand to avoid formatting errors.

Workflow

  1. Add the required plugin: asdf plugin add <name>.
  2. Install the version: asdf install <name> <version>.
  3. Set global default: asdf global <name> <version>.
  4. In a project directory, pin with asdf local <name> <version>.
  5. Verify with asdf current and commit .tool-versions.

Related Skills

  • nvm — dedicated Node.js version manager
  • pyenv — dedicated Python version manager
  • rbenv — dedicated Ruby version manager
  • direnv — per-directory environment variables, integrates with asdf

References

← Back to marketplace