Skip to content
Back to search

marula-review-gauntlet-skill

A pre-push review gauntlet for coding agents: correctness, logic, security, claims and infrastructure passes, then fix and re-review until clean.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/marulahq--marula-review-gauntlet-skill/badge.svg)](/listings/marulahq--marula-review-gauntlet-skill)

HTML

<a href="/listings/marulahq--marula-review-gauntlet-skill"><img src="/api/listings/marulahq--marula-review-gauntlet-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/MarulaHQ/marula-review-gauntlet-skill
cd marula-review-gauntlet-skill
./deploy.sh

The script links both skills into `~/.agents/skills` and into every other agent skills directory it finds: `~/.claude`, `~/.codex`, `~/.cursor`, `~/.gemini`, `~/.copilot`, `~/.config/opencode`. `--copy` copies instead of linking. `--no-pre-review` skips the companion `pre-review` link.

A manual install is the same two lines:

mkdir -p ~/.agents/skills
ln -sfn "$PWD/skills/review-gauntlet" ~/.agents/skills/review-gauntlet
ln -sfn "$PWD/skills/marula-review-gauntlet" ~/.agents/skills/marula-review-gauntlet

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 82 lines
  1. # Review gauntlets
  2. Two agent skills. The portable one runs every local review pass and calls no
  3. external service. The Marula overlay adds the CodeRabbit oracle for Marula Core
  4. pull requests.
  5. | Skill | Use |
  6. | --- | --- |
  7. | `skills/review-gauntlet` | Any repository. Local only. |
  8. | `skills/marula-review-gauntlet` | `MarulaHQ` repositories only. Runs the portable loop, then CodeRabbit. |
  9. ## Why
  10. Across the last 50 merged pull requests in `marula-core`, the external reviewer
  11. posted 248 substantive findings and failed the description check on half the
  12. PRs. 232 of those findings were "quick win", and 86 were prose. The cost was
  13. cheap, artifact-shaped defects being found by the external reviewer instead of
  14. locally.
  15. `skills/review-gauntlet/RESEARCH.md` holds the full breakdown and the evaluation
  16. of the 19 skills that were read before this one was written.
  17. ## Install
  18. ```bash
  19. git clone https://github.com/MarulaHQ/marula-review-gauntlet-skill
  20. cd marula-review-gauntlet-skill
  21. ./deploy.sh
  22. ```
  23. The script links both skills into `~/.agents/skills` and into every other agent
  24. skills directory it finds: `~/.claude`, `~/.codex`, `~/.cursor`, `~/.gemini`,
  25. `~/.copilot`, `~/.config/opencode`. `--copy` copies instead of linking.
  26. `--no-pre-review` skips the companion `pre-review` link.
  27. A manual install is the same two lines:
  28. ```bash
  29. mkdir -p ~/.agents/skills
  30. ln -sfn "$PWD/skills/review-gauntlet" ~/.agents/skills/review-gauntlet
  31. ln -sfn "$PWD/skills/marula-review-gauntlet" ~/.agents/skills/marula-review-gauntlet
  32. ```
  33. ## Use
  34. Ask the agent to "run the review gauntlet", "review until clean", or "pre-push
  35. review". In a MarulaHQ repository, its `AGENTS.md` routes to the overlay, which
  36. also runs the CodeRabbit oracle. Anywhere else, use the portable skill; do not
  37. load the overlay, because it sends the diff to a third-party service.
  38. ## Layout
  39. | Path | Purpose |
  40. | --- | --- |
  41. | `skills/review-gauntlet/SKILL.md` | The portable loop: preflight, seven passes, fix, re-review, report |
  42. | `skills/review-gauntlet/references/logic-pitfalls.md` | Invariant ledger, return paths, bug-report test, failure injection, concurrency, config matrix |
  43. | `skills/review-gauntlet/references/docs-claims.md` | A runbook is a program; claim equals code |
  44. | `skills/review-gauntlet/references/infra-pitfalls.md` | Workflows, shell, Helm, images |
  45. | `skills/review-gauntlet/references/pr-contract.md` | The description check |
  46. | `skills/review-gauntlet/references/coderabbit-path-instructions.md` | Proposed path instructions for Marula's `.coderabbit.yaml` |
  47. | `skills/review-gauntlet/tools/gauntlet.sh` | Mechanical preflight: dead links and paths, ghost env vars, lint, chart render, PR body |
  48. | `skills/review-gauntlet/LEARNINGS.md` | Ledger of misses and the pass that owed them |
  49. | `skills/marula-review-gauntlet/SKILL.md` | The CodeRabbit oracle and the Marula contract, run after the portable loop |
  50. ## Dependencies
  51. The portable skill loads these when the agent has them installed. It vendors
  52. none of them, so there is one source of truth for each:
  53. - `pre-review` for pass 1. Install the companion from
  54. `../marula-code-review-skill` or let `deploy.sh` link it.
  55. - Cloudflare `security-audit` for pass 4, in guidance mode only.
  56. - langgenius `frontend-code-review` for pass 7.
  57. - `receiving-code-review` and `verification-before-completion` for the fix pass.
  58. - The `trail` tools for call sites and file APIs, ahead of grep.
  59. The Marula overlay additionally needs the CodeRabbit CLI, authenticated, and is
  60. only for a repository that already uses CodeRabbit.
  61. ## License
  62. MIT. See `LICENSE`.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.