К основному содержанию
скилл CX Codex

mise — скилл для Claude Code и Codex: управление версиями и задачами

Скилл для Claude Code, Codex, Cursor и других платформ, который обучает агента работать с mise — менеджером версий инструментов, переменных окружения и задач.

MIT 133 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill mise -a claude-code
Открыть на GitHub

Что делает mise

Скилл передаёт агенту знание о том, как mise управляет версиями инструментов через приоритетную цепочку: переменная окружения MISE_<TOOL>_VERSION перекрывает mise.toml в текущей папке, тот — файлы родительских каталогов, а .nvmrc и .python-version читаются в последнюю очередь для обратной совместимости.

Агент сможет пинить версии через mise use node@22, описывать задачи с зависимостями (depends), включать sources и outputs для инкрементальных сборок, подключать .env-файлы через _.file в секции [env]. Бэкенды npm:prettier, cargo:cargo-machete, pipx: и GitHub Releases позволяют устанавливать инструменты без отдельных пакетных менеджеров.

Секреты в mise.toml класть нельзя: скилл знает, что чувствительные значения хранят в .env.local с добавлением файла в .gitignore, а mise activate не подходит для CI-скриптов — там нужен mise exec или eval "$(mise env)".

Какие задачи решает

  • Задать версии Node, Python, Rust, Go и Java в одном файле на проект
  • Заменить Makefile задачами в mise.toml с зависимостями и watch-режимом
  • Перенести проект с asdf или nvm на mise без потери .tool-versions
  • Пробросить переменные окружения отдельно для каждой директории
  • Настроить инкрементальную сборку через sources и outputs у задачи

Примеры запросов агенту

  • Запини Node 22 и Python 3.12 в mise.toml текущего проекта
  • Опиши задачу build в mise.toml с зависимостью от lint и инкрементальной проверкой по src/**
  • Перенеси зависимости из Makefile в mise.toml как задачи с depends и добавь .env.local через _.file

Как установить mise

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill mise -a claude-code

2Вручную: положить файлы

~/.claude/skills/mise/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/mise/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о mise

Как установить скилл mise в Claude Code?

Выполните команду npx skills add oakoss/agent-skills --skill mise -a claude-code. После установки скилл будет доступен по пути ~/.claude/skills/mise/SKILL.md.

Что умеет агент с установленным скиллом mise?

Агент знает команды mise для установки и пинирования версий инструментов, описания задач с зависимостями и watch-режимом, подключения .env-файлов и использования бэкендов npm, cargo, pipx и GitHub Releases.

Поддерживает ли скилл mise совместимость с .tool-versions от asdf?

Да. Mise читает .tool-versions как один из источников в цепочке приоритетов, поэтому миграция с asdf не требует немедленного переписывания файлов — mise.toml просто перекрывает его при наличии.

Исходный текст

SKILL.md · MIT
---
name: mise
description: |
  Mise (formerly rtx) polyglot tool version manager, environment variable manager, and task runner. Covers tool version management (install, use, pin across Node/Python/Rust/Go/Java and more), mise.toml task definitions (scripts, dependencies, watch mode, incremental builds), environment variable management (.env integration, per-directory env, redaction), project-level tool pinning, backend system (asdf, npm, pipx, cargo, GitHub releases), and comparison with alternatives (asdf, nvm, pyenv, Makefiles).

  Use when configuring development tool versions, defining project tasks in mise.toml, managing per-project environment variables, setting up polyglot dev environments, migrating from asdf or nvm, or automating build/test/lint/deploy workflows with mise run.
license: MIT
metadata:
  author: oakoss
  version: '1.0'
  source: 'https://mise.jdx.dev'
user-invocable: false
---

# Mise

## Overview

Mise is a **polyglot development tool manager** that handles tool versions, environment variables, and task running in a single CLI. It replaces asdf, nvm, pyenv, direnv, and Makefiles with a unified `mise.toml` configuration per project.

**When to use:** Managing multiple language runtimes per project, defining reproducible dev environments, running project tasks with dependencies, replacing scattered `.nvmrc`/`.python-version`/`.tool-versions` files, automating CI pipelines.

**When NOT to use:** Container-only workflows where all tools live in Docker images, single-language projects already well-served by their native version manager, production runtime management (mise is a dev tool).

## Version Resolution Order

Mise resolves tool versions by checking these sources in priority order:

1. `MISE_<TOOL>_VERSION` environment variable
2. `mise.toml` in current directory
3. `mise.toml` in parent directories (walks up the tree)
4. `.tool-versions` file (asdf compatibility)
5. Legacy files (`.nvmrc`, `.python-version`, `.ruby-version`)
6. `~/.config/mise/config.toml` (global default)

## Quick Reference

| Pattern               | Command / Config                           | Key Points                                  |
| --------------------- | ------------------------------------------ | ------------------------------------------- |
| Install tools         | `mise install`                             | Reads mise.toml, installs all listed tools  |
| Pin tool version      | `mise use node@22`                         | Writes to mise.toml in current directory    |
| Pin globally          | `mise use -g node@22`                      | Writes to ~/.config/mise/config.toml        |
| Run a task            | `mise run build`                           | Runs task defined in mise.toml              |
| Run with args         | `mise run test -- --watch`                 | Passes args after `--` to the task          |
| Watch mode            | `mise watch build`                         | Re-runs task when sources change            |
| List tasks            | `mise tasks`                               | Shows all available tasks                   |
| Set env vars          | `[env]` section in mise.toml               | Per-directory, auto-activated on cd         |
| Load .env file        | `_.file = ".env"`                          | Loads dotenv into environment               |
| Extend PATH           | `_.path = ["./bin"]`                       | Prepends directories to PATH                |
| List installed        | `mise ls`                                  | Shows all installed tool versions           |
| Outdated tools        | `mise outdated`                            | Shows tools with newer versions             |
| Upgrade tools         | `mise upgrade`                             | Upgrades tools to latest within constraints |
| Trust config          | `mise trust`                               | Trusts mise.toml in current directory       |
| Tool backends         | `"npm:prettier"` / `"cargo:cargo-machete"` | Install from npm, cargo, pipx, GitHub, etc. |
| Task dependencies     | `depends = ["lint", "test"]`               | Prerequisite tasks run first                |
| Incremental build     | `sources` + `outputs` on task              | Skips task if outputs newer than sources    |
| Exec without activate | `mise exec -- node app.js`                 | Runs command with mise-managed tools        |
| Diagnostics           | `mise doctor`                              | Check installation and config health        |
| Prune unused          | `mise prune`                               | Remove tool versions not in any config      |
| Generate hook         | `mise generate git-pre-commit`             | Generate git pre-commit hook for tasks      |
| Env-specific config   | `.mise.staging.toml`                       | Activated via `MISE_ENV=staging`            |
| Shims for IDEs        | `mise settings set shims_on_path true`     | PATH-based shims for IDE compatibility      |

## Common Mistakes

| Mistake                                          | Correct Pattern                                                      |
| ------------------------------------------------ | -------------------------------------------------------------------- |
| Using `mise install node@22` without `mise use`  | `mise use node@22` both installs and pins to mise.toml               |
| Editing `.tool-versions` manually with mise      | Use `mise use` to update; mise.toml is preferred over .tool-versions |
| Forgetting `mise trust` on new project clone     | Run `mise trust` to activate untrusted config files                  |
| Using `depends` key for task dependencies        | Current key is `depends` (array), not `deps`                         |
| Running `mise run` without activating mise       | Run `mise activate` in shell profile or use `mise exec`              |
| Putting secrets directly in mise.toml            | Use `_.file = ".env.local"` and gitignore the .env file              |
| Expecting env vars without `cd`-ing into project | Mise activates env on directory change; use `mise env` to debug      |
| Using `latest` version in shared projects        | Pin specific major versions (`node = "22"`) for reproducibility      |
| Defining tasks in Makefile alongside mise        | Consolidate all tasks in mise.toml for one tool                      |
| Missing shebang in multi-line task scripts       | Add `#!/usr/bin/env bash` for explicit interpreter                   |
| Not using `sources`/`outputs` for slow tasks     | Define source globs for incremental skipping and watch mode          |
| Using `mise activate` in non-interactive scripts | Use `mise exec` or `eval "$(mise env)"` in scripts and CI            |

## Delegation

- **Task pattern discovery**: Use `Explore` agent
- **Configuration review**: Use `Task` agent
- **CI pipeline integration**: Use `Task` agent

> If the `rust` skill is available, delegate Rust toolchain management patterns to it.
> If the `python-uv` skill is available, delegate Python version and virtual environment patterns to it.
> If the `github-actions` skill is available, delegate CI workflow patterns to it.
> If the `docker` skill is available, delegate containerized workflow patterns to it.
> If the `pino-logging` skill is available, delegate logging configuration patterns to it.
> If the `sentry` skill is available, delegate error monitoring setup patterns to it.

## References

- [Tool version management and backends](references/tool-management.md)
- [Task definitions, dependencies, and scripts](references/task-runner.md)
- [Environment variables and dotenv integration](references/environment-variables.md)
- [Configuration files and settings](references/configuration.md)
- [Common task patterns for projects](references/task-patterns.md)
- [Migration from asdf, nvm, and alternatives](references/migration.md)

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
playwright-release-notes microsoft Скилл playwright-release-notes для Claude Code автоматизирует создание и перевод релиз-ноутсов Playwright. Он запускается, когда нужно подготовить документацию к новому релизу. CX Codex +1 130установок clickup civitai Подключает ClickUp API прямо в агент. Читает задачи по URL или ID, создаёт, переназначает, обновляет статус и добавляет комментарии. CX Codex +1 1 800установок github-workflow-automation ruvnet Скилл github-workflow-automation автоматизирует GitHub Actions с координацией AI-агентов. Генерирует оптимальные pipeline, управляет pull request'ами, анализирует баги и развёртывает обновления с минимальными рисками. CX Codex +1 1 300установок cyrus-setup-prerequisites cyrusagents Скилл cyrus-setup-prerequisites для Claude Code, который проверяет системные зависимости перед установкой Cyrus и ставит пакет cyrus-ai. Работает на Node.js 18+ и не читает секреты из ~/.cyrus/.env. CX Codex +1 1 100установок env-manager bobmatnyc Скилл env-manager проверяет .env, ищет секреты в клиентских переменных и сравнивает файл с .env.example. Пригодится перед деплоем и при онбординге. CX Codex +1 358установок github-webhooks hookdeck Скилл github-webhooks для приёма и проверки вебхуков GitHub: подсказывает, как разобрать подпись и обработать события push, pull_request, issues и release. CX Codex +1 512установок

Из того же набора106

Весь набор →
tanstack-db Помогает проектировать реактивное клиентское хранилище на TanStack DB: живые запросы, связи коллекций и оптимистичные изменения. Описывает локальные данные и синхронизацию. CX Codex +1 136установок prompt-engineering Скилл prompt-engineering для Claude Code собирает приёмы проектирования промптов: цепочки рассуждений, ReAct-циклы, шаблоны системных промптов, extended thinking и сжатие контекста. CX Codex +1 135установок react-error-handling Скилл react-error-handling помогает проектировать предохранители и запасные интерфейсы в React, чтобы сбой в дочернем компоненте не ломал всё приложение. CX Codex +1 134установок frontend-builder Скилл frontend-builder помогает спроектировать и собрать интерфейс на React или Next.js: от компонентов и состояния до форм, стилей и обработки ошибок. Пригодится при создании веб-приложения или выборе архитектуры. CX Codex +1 134установок data-visualizer Скилл data-visualizer помогает строить графики и дашборды на Recharts, Chart.js или D3.js с учётом адаптивности и доступности. CX Codex +1 133установок knowledge-base-manager Скилл knowledge-base-manager для Claude Code помогает выбрать архитектуру базы знаний и выстроить её поддержку. Охватывает отбор контента, контроль качества и версионирование. CX Codex +1 131установок secure-ai Скилл secure-ai для защиты LLM-слоя приложения: инъекции в промпт, проверка вывода модели, zero-trust для агентов с инструментами. CX Codex +1 130установок python-uv Скилл python-uv обучает ИИ-агента вести Python-проекты через uv: от uv init и управления зависимостями до рабочих пространств и сборки пакетов. Помогает отказаться от связки pip и poetry. CX Codex +1 129установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой