Menú
Verify and install the prerequisites for minimise — the `mini` CLI, the `claude` CLI, and a git repo.
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
Author a mini job or loop plan under control — triage loop-vs-job, run a retrieval-aware interview pre-filled from existing personas and recent runs, then preview the exact YAML behind an approve/edit/reject gate before handing off to the unchanged `mini job new` / `mini loop new`. Use when starting a new job or loop from a one-liner and you want to review the plan before anything runs.
Run multi-step work as a background minimise job — authors a plan YAML, wires the review gates, runs it, and reports what landed.
Reviews what a minimise job actually IMPLEMENTED against its plan — a NON-BLOCKING advisory reviewer that reads the plan (YAML) from stdin, inspects the job's git diff, and reports findings without ever aborting the job. Use when invoked as `/minimise:review-implementation`, or when a minimise `post_plan` hook runs `claude -p '/minimise:review-implementation'` to critique the finished work. Always exits reporting; it never fails the job. Checks correctness, completeness vs. the plan's goals, obvious bugs, missing tests, and over-engineering — mirroring ralphex's post-implementation review, trimmed to the essentials.
Reviews a minimise job plan or loop spec as a pragmatic BLOCKING quality gate, reading it (YAML) from stdin and printing a machine-readable REVIEW: PASS / REVIEW: FAIL verdict. Use when invoked as `/minimise:review-plan`, or when a minimise `pre_plan` hook runs `claude -p '/minimise:review-plan'` to gate a job before implementation. Reports ONLY severe issues (correctness bugs, data-loss/destructive risk, missing steps that make a task unimplementable, internal contradictions, factually wrong claims about the codebase, a loop goal with no stopping condition) and ignores style, wording, and nice-to-haves.
Run open-ended iteration on one artifact as a minimise refinement loop — plan → implement → evaluate, repeating until the goal is met or max_iterations is hit.
| name | setup |
| description | Verify and install the prerequisites for minimise — the `mini` CLI, the `claude` CLI, and a git repo. |
Get mini working in the user's current project. Verify first, install only what is
missing, and write nothing into their repo.
This skill is read-only with respect to the user's repository. It must NOT create or edit
.claude/settings.json, hooks, plan files, scaffolding, or any other file in their project.
All minimise state (config, database, job dirs) lives in ~/.minimise/, which is created
automatically on first run. If the user asks for project scaffolding, that is a different
conversation — say so rather than quietly writing files.
mini --help # the minimise CLI (there is no --version flag)
claude --version # the agent harness minimise shells out to for every task
git rev-parse --show-toplevel # jobs run inside a git repo; commits/diffs track task output
Report each as present or missing before doing anything about it.
claude missing — minimise cannot execute a single task without it. Point the user at
https://docs.anthropic.com/en/docs/claude-code and stop; do not try to install it for them.git init (or move to a repo) and stop. Do not git init for them.mini missing — install it (below).mini if it is missingRequires Python 3.9+. From a local clone:
pip install -e . # run from the minimise repo root
Or straight from the repo:
pip install git+https://github.com/dosatos/minimise.git
Then re-verify — an install that does not put mini on PATH is not an install:
mini --help
If it still is not found, the likely cause is a pip that installed into a different Python
than the one on PATH (pyenv/venv mismatch). Say that plainly and show which -a python3 pip
rather than guessing.
When all three checks pass, tell the user:
~/.minimise/ (auto-created on first run) — nothing was added to their project./minimise:brainstorm — author a job or loop plan under control before handing off./minimise:job — run multi-step work as a background job./minimise:loop — iterate on one artifact until the goal is met./minimise:review-plan — review a plan YAML (also usable as a blocking pre_plan hook)./minimise:review-implementation — review what a job implemented against its plan.mini job list (empty list = working install).