mthds-upgrade

Upgrade MTHDS CLI tools with environment checks and forced update validation.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/mthds-ai/mthds-plugins --skill mthds-upgrade
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mthds-upgrade
Source: https://github.com/mthds-ai/mthds-plugins/tree/main/mthds-codex/skills/mthds-upgrade
Command: npx skills add https://github.com/mthds-ai/mthds-plugins --skill mthds-upgrade

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents broken or incompatible MTHDS workflows caused by outdated CLI tooling by automating version checks, interpreting agent output, and guiding safe upgrades so users don't face silent failures during method builds or runs.

Core Features & Use Cases

  • Environment preflight: Runs an environment check and interprets specific status tokens to decide whether to stop, warn, or proceed.
  • Force and apply updates: Executes a forced update-check, understands responses like UPGRADE_AVAILABLE or JUST_UPGRADED, and follows the documented upgrade flow with user prompts.
  • Reporting and recovery: Summarizes which tools were checked, what changed (old → new), and provides manual-install commands when automatic upgrades fail; suitable for CLI maintenance, CI runner preparation, and developer workstation onboarding.
  • Use Case: A developer asks to "upgrade mthds" and the Skill validates the agent, offers to upgrade mthds-agent if required, updates managed tools, and returns a concise summary of results.

Quick Start

Upgrade my MTHDS CLI tools to the latest compatible versions.

Frequently Asked Questions about mthds-upgrade

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

FAQPage Schema
How do I upgrade MTHDS CLI tools to the latest compatible versions?

To upgrade MTHDS CLI tools, the Skill validates the mthds-agent environment, executes a forced update-check, and follows the documented upgrade flow with user prompts to update managed tools like plxt and pipelex.

Why does my mthds-agent workflow fail after a toolchain update?

MTHDS workflows fail after updates due to incompatible CLI tooling versions. The Skill prevents this by running environment preflight checks, interpreting status tokens, and guiding coordinated upgrades across the managed toolchain.

Can I force an update check for mthds-agent managed CLIs?

Yes, you can force an update check for mthds-agent managed CLIs. The Skill executes a forced update-check, parses the output responses, and applies updates to tools like plxt and pipelex while prompting the user.

What should I do if an automatic MTHDS CLI upgrade fails?

If an automatic MTHDS CLI upgrade fails, the Skill provides manual-install commands as a recovery option. It summarizes which tools were checked, what changed from old to new versions, and offers the commands needed for manual installation.

Do I need mthds-agent installed to use the MTHDS upgrade flow?

Yes, mthds-agent presence is required to use the MTHDS upgrade flow. The Skill depends on the agent, the environment-check utility, and parsing of update-check outputs to perform coordinated upgrades across managed CLI tools.