Diagnose and fix broken, misconfigured, or misbehaving moon tasks.
npx skills add https://github.com/notwillk/rulesy --skill debug-task-notwillk
Please help me install this Agent Skill. Skill: debug-task Source: https://github.com/notwillk/rulesy/tree/main/.agents/skills/debug-task Command: npx skills add https://github.com/notwillk/rulesy --skill debug-task-notwillk
moon task <project>:<task> --json to verify command vs script usage, inputs, outputs, deps, checks, tags, and inheritance merge results. - Cache Diagnosis: Compares hash manifests with moon hash to pinpoint stale cache hits, unexpected cache misses, and outputs that fail to restore after hydration. - Symptom-to-Cause Mapping: A lookup table routes symptoms like "nothing to do", pipeline hangs, mutex contention, and runInCI surprises to the correct reference guide. - Use Case: A developer's build task re-runs on every CI run despite unchanged sources; the Skill walks them through hash diffing to discover a volatile fingerprint check output invalidating the cache. ## Quick Start Ask the assistant to debug why your moon task is failing or misbehaving, providing the specific project:task target to inspect.High-intent search queries and answers about installing and using this skill.
Start by inspecting the resolved configuration with `moon task <project>:<task> --json`, then run with `moon run <target> --log debug --force` to see toolchain resolution, hash generation, and process execution details.
Cache misses happen when inputs are too broad, outputs contain volatile files like timestamps, or a fingerprint check produces changing output. Diff two consecutive runs with `moon hash <hash1> <hash2>` to find the changing field.
Common causes include the --affected flag with no changed inputs, runInCI settings like 'only' or 'skip', an os platform filter, or all condition checks passing in v2.4. Check options in `moon task <target> --json`.
Dependency cacheStrategy and task tags require moon v2.3 or later, while task checks (requirement, condition, fingerprint) and project-level taskOptions require v2.4. The skill overall requires moon v2.0 minimum.
A persistent task listed in another task's deps causes a hard error in moon v2, and shared mutex values can serialize or deadlock tasks. Visualize the dependency chain with `moon action-graph <target>` to find the blocking node.
This skill only diagnoses existing tasks; it does not cover creating new tasks, setting up workspaces, configuring toolchains, or learning moon concepts. Use moon's official documentation for those scenarios.
dxosConfigure and orchestrate moonrepo monorepo workspaces, tasks, toolchains, and CI pipelines.
trypanicEnforce canonical moon v2 and proto configuration patterns in polyglot monorepos.
ChatAndBuildConfigure Turborepo task outputs, cache keys, and remote cache usage.
Uxcel-LabOrchestrates foundations, components, screens, and flows into a complete from-scratch UX design build.