Slopmop
Testing & QualityslopmopSlopmop is an Agent Skill for testing & quality published in the davepoon/buildwithclaude repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Trigger when you would normally reach for pytest, gh, mypy, black, or other raw repo tooling. Redirect to `sm swab`, `sm scour`, `sm buff`, `sm sail`, `sm refit`, or `sm doctor` so remediation follows the established rails. Also trigger when filing issues about slop-mop friction — use `sm barnacle file` / `/slopmop:sm-barnacle`, never `gh issue create`.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/davepoon/buildwithclaude/blob/HEAD/plugins/slopmop/skills/slopmop/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/slopmop, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Slop-mop skill
Filing slop-mop friction? Use
/slopmop:sm-barnacleorsm barnacle file— nevergh issue createdirectly. The barnacle CLI auto-applies the correct labels and targets the right repo regardless of where you are.
Slop-mop (sm) has two primary modes: refit (one-time onboarding) and maintenance (steady-state development). Refit remediates all existing slop and installs permanent guards; the swab/scour/buff loop then keeps the repo clean as you work.
When to use
- Default action: Run
sm sailwhen you're not sure what's next — it reads workflow state and does the right thing. - Refit (step 0): Run
sm refit --startto generate a remediation plan, thensm refit --iterateuntil complete, thensm refit --finishto enter maintenance. - During implementation: Run
sm swabafter every meaningful code change. Keep running until clean. - Before PR: Run
sm scourfor a comprehensive sweep. - After CI/review: Run
sm buff <PR_NUMBER>to convert feedback into next steps.
The maintenance loop
Fastest path: sm sail → fix what it finds → sm sail → repeat until PR lands
Manual path: write code → sm swab → fix → repeat → sm scour → sm buff <PR#>
sm sail automates verb selection. Use individual verbs (sm swab -g <gate>, sm buff resolve, etc.) for surgical work.
Refit (before entering the loop)
Refit is not part of the maintenance loop. It is step 0 — how you earn the right to enter the loop.
sm refit --start → fix one gate → sm refit --iterate → ... → sm refit --finish
Prerequisite
The sm CLI must be installed in the user's environment. If invocation fails with "command not found", suggest:
pipx install slopmop[all]
Then re-run the command.
Safety
- Never bypass or silence a failing check — that's how repo rot compounds.
- If a gate seems wrong, tune it or file a bug. Don't disable it as a workaround.
- Report friction (invalid guidance, broken state, blocked rails) via
/slopmop:sm-barnaclerather than working around it.
Reference
Full project docs: https://github.com/ScienceIsNeato/slop-mop Workflow state machine: https://github.com/ScienceIsNeato/slop-mop/blob/main/DOCS/WORKFLOW.md Gate reasoning: https://github.com/ScienceIsNeato/slop-mop/blob/main/DOCS/GATE_REASONING.md