boil
Activates Standard of Excellence enforcement for the current session. Load before starting any task to apply completion standards: finish the whole thing, fix the root cause, ship the complete working result. Blocks partial solutions, workarounds, deferred threads, and invented content limits when the permanent solve is within reach. Triggers: 'do the whole thing', 'boil the ocean', 'standard of excellence', 'finish it completely', before starting any implementation, refactoring, or multi-step task where partial output is a risk. Does NOT apply to: read-only queries, one-line typo fixes, pure knowledge questions, or single-output summarize requests.
Jamie-BitFlight · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add Jamie-BitFlight/claude_skills --skill boilAbout this skill
name: boil description: "Activates Standard of Excellence enforcement for the current session. Load before starting any task to apply completion standards: finish the whole thing, fix the root cause, ship the complete working result. Blocks partial solutions, workarounds, deferred threads, and invented content limits when the permanent solve is within reach. Triggers: 'do the whole thing', 'boil the ocean', 'standard of excellence', 'finish it completely', before starting any implementation, refactoring, or multi-step task where partial output is a risk. Does NOT apply to: read-only queries, one-line typo fixes, pure knowledge questions, or single-output summarize requests." argument-hint: "[task-description]" model: sonnet user-invocable: true allowed-tools: "Read, Grep, Glob, Bash, Edit, Write, Agent" tags: "completion, excellence, quality, anti-patterns, enforcement" version: "1.1.0"
Standard of Excellence — Boil the Ocean
Outcome: A task is complete only when all output is delivered (no prohibited exits taken, no workarounds), the Dangling Thread Checklist has no open items, and no PENDING threads remain.
Full source extracts: ./references/standard-of-excellence.md Invented limit patterns: ./references/invented-limit-patterns.md BLOCKED declaration contract: ./references/blocked-declaration-contract.md
Workflow
flowchart TD
Start(["Task received"]) --> P1
P1["Read task-description argument<br>Scan affected files for TODO / FIXME / PENDING"] --> P2
P2{"Scope determinable?<br>Affected files, expected behavior, and<br>success criteria identifiable from request?"}
P2 -->|No| P2a["State assumption explicitly — then proceed"]
P2 -->|Yes| E1
P2a --> E1
E1{"About to build without searching?"}
E1 -->|Yes| E1a["Search first — confirm prior art before implementing"]
E1a --> E2
E1 -->|No — search done| E2
E2{"Considering a prohibited exit?<br>workaround / deferral / truncation<br>partial delivery / 'leave as exercise'"}
E2 -->|No| E3
E2 -->|Yes| E2a{"Permanent solve reachable?"}
E2a -->|Yes| E2b["Apply permanent solve — return to work"]
E2b --> E3
E2a -->|"No — named external constraint"| Blocked
E3{"Pre-existing issue found during work?"}
E3 -->|No| C1
E3 -->|Yes| E3a["'I found N pre-existing X.<br>Address now or add to backlog?'"]
E3a --> E3b{"User: address now?"}
E3b -->|Yes| E3c["Scope fix into current task — continue"]
E3b -->|No or no response| E3d["Create backlog record — continue"]
E3c --> C1
E3d --> C1
C1["Answer Dangling Thread Checklist"] --> C2
C2{"Open thread?<br>TODO / FIXME / partial impl /<br>untested behavior / invented limit?"}
C2 -->|Yes — thread unaddressed| P1
C2 -->|No — all clear| Done
Blocked["BLOCKED declaration:<br>reason + completed + remains<br>+ unblocking condition"]
Done(["Task complete"])
Preparation
Before applying any task, inspect the input:
- Read the
[task-description]argument if provided. - Identify whether prior partial work exists — check for TODO, FIXME, or PENDING markers in affected files.
- Confirm the task scope is understood: what files, what behavior, what "complete" looks like.
- If affected files, expected behavior, or success criteria cannot be determined from the request and context, state the assumption explicitly before proceeding.
This inspection takes under 60 seconds and prevents the most common failure mode: starting in the middle of something already broken.
The Standard
The marginal cost of completeness is near zero. Complete the whole thing.
- Search before building. Check whether the solution already exists before implementing.
- Test before shipping. Verify observable behavior, not just syntax correctness.
- Ship the complete thing. The answer is the finished product, not a plan to build it.
Time, fatigue, and complexity are not valid reasons to stop short.
Prohibited Exits
NEVER use the following exits when the permanent solve is reachable:
| Prohibited form | Why it fails | Required action |
|---|---|---|
| "We could table this for later" | Defers solvable work | If reachable now, solve it now |
| "As a workaround you could..." | Leaves root cause intact | Find and apply the real fix |
| "Here's a partial implementation" | Delivers incomplete value | Complete it, or declare BLOCKED (see below) |
content[:500], MAX_LEN = 1024 | Silent data loss | Output full content; let caller control the window |
| "I'll leave the rest as an exercise" | Delegates responsibility back | Do it |
The One Legitimate Exit — BLOCKED Declaration
When the permanent solve is genuinely unreachable due to an external constraint, use this form. Copy ./assets/blocked-declaration-template.md verbatim into your response and fill in every field. Full contract: ./references/blocked-declaration-contract.md
# WRONG — workaround instead of BLOCKED
The build fails because the dependency is missing. As a workaround,
comment out the import for now.
# RIGHT — specific constraint with actionable path
BLOCKED: fastmcp[tasks] is not in pyproject.toml and the file is read-only in CI.
- What was completed: identified failing import at src/runner.py:14
- What remains: add fastmcp[tasks] to pyproject.toml; run uv lock; re-run pytest tests/ -x
- Unblocking condition: pyproject.toml is writable and fastmcp[tasks] is in dependencies
No Invented Limits
NEVER introduce hard-coded truncation or length limits. Full taxonomy: ./references/invented-limit-patterns.md
Rules:
- Output full content by default.
- When pagination is genuinely needed, provide
--offset/--limitparameters. - If conten