debug-task
About debug-task
Diagnose and fix moon tasks that are broken, misconfigured, or behaving unexpectedly. Use this skill when a moon task is failing, not running, skipped, hanging, producing stale or wrong output, cached when it shouldn't be, re-running every time, or missing outputs after a cache hit. Also covers pipeline hangs, tasks that only work in CI but not locally (or vice versa), tasks skipped by --affected, and task inheritance not applying to a project. Activate on any mention of "moon run" or "moon task" combined with a problem — errors, stale cache, missing outputs, wrong results, "nothing to do", or unexpected behavior. Also use for task options (persistent, runInCI, allowFailure, expectFailure, envOverride, affectedFiles, mutex, timeout, outputStyle, cacheLifetime), task checks, cleanup and wait dependencies, and project-level taskOptions. Not for creating new tasks, setting up workspaces, configuring toolchains, or learning moon concepts.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / moonrepo/ moon --skill debug-taskAfter installing, type/debug-taskin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/cache-issues.mdconfig-mistakes.mddecision-tree.mdenvironment-debug.md