mise-contrib-add-registry

Create registry/<name>.toml files to register new mise tools.

1|1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/ray-manaloto/claude-code-marketplace --skill mise-contrib-add-registry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mise-contrib-add-registry
Source: https://github.com/ray-manaloto/claude-code-marketplace/tree/main/mise-toolkit/skills/mise-contrib-add-registry
Command: npx skills add https://github.com/ray-manaloto/claude-code-marketplace --skill mise-contrib-add-registry

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating a registry entry for a new tool in mise is the standard and fastest path to enable install via a short name by declaring backends and a basic test.

Core Features & Use Cases

  • Single-file registry entry: Create registry/<name>.toml to register a tool name used by mise use.
  • Backend selection guidance: Follow the official order (aqua, github/gitlab/forgejo, pipx, npm, go/cargo/dotnet) to maximize compatibility.
  • Validation and workflow: Provides a repeatable workflow for contributors to describe backends, tests, and discovery.

Quick Start

Create a new file at registry/<tool-name>.toml with backends and a simple smoke test, then run mise install <tool-name>@latest.

Frequently Asked Questions about mise-contrib-add-registry

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new tool to the mise registry?

To add a tool to the mise registry, create a TOML file at registry/<name>.toml declaring available backends and a smoke test. This registers the short-name so users can install it via mise use.

What backend should I choose when registering a tool in mise?

When registering a tool in mise, follow the official backend order: aqua, github/gitlab/forgejo, pipx, npm, then go/cargo/dotnet. This selection order maximizes compatibility across different platforms.

Why do I need a smoke test when creating a mise registry entry?

A smoke test is required when creating a mise registry entry to validate the tool installation. It ensures the declared backends function correctly and the tool is discoverable before users run mise install.

What is the correct file format for a mise registry contribution?

The correct file format for a mise registry contribution is a TOML file located at registry/<name>.toml. This single-file entry enforces concise description fields, backend declarations, and test commands.

Can I use pipx or npm as backends for a mise registry entry?

Yes, you can use pipx or npm as backends for a mise registry entry. The contribution workflow supports multiple backends including aqua, github, go, cargo, and dotnet to maximize installation compatibility.

Does adding a short-name tool to mise require multiple configuration files?

No, adding a short-name tool to mise requires only a single-file registry entry. You create one registry/<name>.toml file to declare backends and a basic test for the contribution workflow.