skills/mp-check-fix/SKILL.md
Detects the project's check scripts, runs them, and fixes what fails.
npx skillsauth add MartinoPolo/mpx-claude-code mp-check-fixInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Deterministic check execution and fix loop based on detect-check-scripts.sh.
This skill accepts no arguments. Ignore argument-based filtering and follow detector output only.
bash $HOME/.claude/scripts/detect-check-scripts.sh
Handle all outputs explicitly:
NO_PROJECT=true: report "No package.json found" and stop.PM_UNKNOWN=true: ask user which package manager to use (npm, pnpm, yarn, bun), then re-run:bash $HOME/.claude/scripts/detect-check-scripts.sh . <chosen_pm>
PM=<pm>: continue with detected scripts.MONOREPO=true: expect package-prefixed keys too (for example packages_ui_CHECK_ALL=...).Possible script keys per scope (root or prefixed package):
<prefix>CHECK_ALL, <prefix>CHECK_ALL_DIR<prefix>TYPECHECK, <prefix>TYPECHECK_DIR<prefix>LINT, <prefix>LINT_DIR<prefix>FORMAT, <prefix>FORMAT_DIR<prefix>BUILD, <prefix>BUILD_DIRIf no runnable script keys are present after PM=..., report "No scripts detected" and stop.
Per scope:
CHECK_ALL exists: run CHECK_ALL, then BUILD (if present).CHECK_ALL does not exist: run detected TYPECHECK, LINT, FORMAT, then BUILD.Never filter checks by user arguments. The detector output fully determines what runs.
Run planned commands in deterministic order.
CHECK_ALL mode: CHECK_ALL -> BUILDTYPECHECK -> LINT -> FORMAT -> BUILDFor monorepo keys, run from *_DIR:
cd <DIR> && <COMMAND>
Run sequentially. Stop at first failing command, fix it, then continue.
If a check fails:
Repeat up to 3 iterations per failed command. If still failing, mark as Failed and continue.
Continue through remaining planned commands. Each command has its own 3-iteration fix budget.
Summarize status for each attempted command/scope:
Passed: passed immediatelyFixed: failed initially, passed after fixesFailed: still failing after 3 iterationsSkipped: not detected for that scope or superseded by CHECK_ALLReport in execution order. Include scope (root or package prefix) and command used.
Recommended table:
Scope | Command | Status | Notes
| Problem | Action |
| ---------------------------------- | ------------------------------------------------------------------ |
| NO_PROJECT=true | Run from a folder containing package.json |
| PM_UNKNOWN=true | Ask user for package manager and re-run detector with arg 2 |
| PM=... but no script keys | Report "No scripts detected" and stop |
| Prefix keys present (apps_api_*) | Treat each prefix as its own scope; run with corresponding *_DIR |
@ts-ignore, eslint-disable)tools
Show current project progress. Displays phase status and next steps. Use when: "show status", "project progress", "what's done"
data-ai
Unified project setup. Auto-detects state and orchestrates mpx skills/agents for init, conversion, or restructure.
testing
Track bugs/issues in .mpx/ phase system. Parses reports, finds related phases, adds fix tasks or creates bugfix phases. Use when: "track this bug", "add issue to project", "log this bug", "add bug to checklist"
development
Project workflow guidance for spec-driven development. Background knowledge auto-loaded when relevant.