Skip to content

akunzai/agent-skills / skills/mise

mise: set up a project's toolchain in mise.toml, migrate Makefile or npm scripts to tasks, or wire mise into CI or containers.

mise

One committed mise.toml is the single source for tools, runtimes, and tasks. Official surface: https://mise.jdx.dev/. This skill is the conventions.

Host

  1. Author repo-root mise.toml with [tools] and [tasks.*]. That filename is the default; other mise config paths (.mise.toml, mise/config.toml, …) only when the user names the file. Edit an existing mise config in place rather than adding a second one. Versions live only there — after a migrate, drop package.json packageManager / corepack. Prefer aqua: and github: (built in, provenance-verified); ubi:owner/repo becomes github:owner/repo. Enable idiomatic files only for interop: mise settings add idiomatic_version_file_enable_tools node. Done when the file is repo-root mise.toml (unless the user named another path) and tool versions are declared only there, except idiomatic files enabled for interop.

  2. Prefix runtimes; latest for linters. go = "1.27", python = "3.14", java = "temurin-25", node = "lts", dotnet = "10" install the newest matching release. Exact patches stay frozen. Go ≤1.20 needs prefix:1.20 because 1.20 is an exact tag (Go). npm ranges (1.27.x, ^1.27) are rejected. .NET shares DOTNET_ROOT (global.json selects SDK); side-by-side runtimes use tool options (dotnet = ["10", { version = "8.0.14", runtime = "aspnetcore" }]), where runtime needs an exact patch.

[tools]
shellcheck = "latest"
actionlint = "latest"
uv = "latest"
go = "1.27"
node = "lts"
java = "temurin-25"
python = "3.14"

[tasks.test]
description = "Run all test scripts"
run = "..."

[tasks.lint]
description = "Run all linters"
depends = ["lint-shell", "lint-actions"]
  1. Translate Makefile or npm script targets into [tasks] verbatim: same names, same shell (pipes, loops, $()), depends for the old order. Drive work with mise run <task>.

  2. First checkout: mise trust, then mise install. Done when mise run <task> runs on the declared tools. Untrusted configs make install and tasks silently no-op; jdx/mise-action trusts in CI. On a Gatekeeper warning for a precompiled binary (e.g. PHP): xattr -d com.apple.quarantine ~/.local/share/mise/installs/<tool>/<version>/....

CI

jdx/mise-action@v4 reads mise.toml and replaces per-tool setup actions (actions/setup-python, astral-sh/setup-uv, …). Run work through tasks:

- uses: jdx/mise-action@v4
- run: mise run test
- run: mise run lint

Scope a job with install_args (node bun) so versions still come only from mise.toml and a JS job does not pull unrelated SDKs. Done when the job has no duplicate setup action for a tool already in mise.toml.

Containers

Pin the mise binary by version and sha256 (curl | bash is not a pin). mise install --system lands in /usr/local/share/mise; make it world-readable so a uid-dropped runtime user sees the tools. Done when that user can run the declared binaries.

slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 197kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall