Skip to main content
skill CX Codex

brutal-honesty-review — Claude Code skill for code review

The brutal-honesty-review skill guides an agent through blunt reviews of code, tests, and technical decisions. It asks what is broken, why it matters, and how to fix it.

MIT 186 installs ★ 533 updated 2026-11-04

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add proffesor-for-testing/agentic-qe --skill brutal-honesty-review -a claude-code
Open on GitHub

What brutal-honesty-review does

The skill offers three review modes: Linus for technical mistakes, Ramsay for weak quality, and Bach for scrutinizing questionable practices or claims. Reviews follow a clear sequence: identify the problem, explain the reason, describe the correct outcome, and give a practical fix.

Every finding needs evidence, such as a file and line, command output, test result, or quotation. Unsupported criticism is dropped or marked as a hypothesis or open question. There is no quota for findings.

The guidance rules out first PRs from junior developers, demoralized teams, and public forums. In those settings, harsh delivery can do harm; criticism should target the work, not the person.

What it helps with

  • spot technical errors in a code change
  • find gaps in test coverage
  • examine flaws in an architectural decision
  • challenge unsupported certification or vendor claims

Example prompts for the agent

  • Review this diff in Linus mode; support each finding and give concrete fixes.
  • Assess these tests in Ramsay mode and point out missing scenarios.
  • Examine this certification requirement in Bach mode; separate evidence from assumptions.

How to install brutal-honesty-review

1Skills CLI (Vercel)

npx skills add proffesor-for-testing/agentic-qe --skill brutal-honesty-review -a claude-code

2Manually: put the files in place

~/.claude/skills/brutal-honesty-review/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/brutal-honesty-review/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about brutal-honesty-review

How do I install brutal-honesty-review in Claude Code?

Run npx skills add proffesor-for-testing/agentic-qe --skill brutal-honesty-review -a claude-code. The skill file is at ~/.claude/skills/brutal-honesty-review/SKILL.md.

What does brutal-honesty-review do?

It guides an agent through critical reviews of code, tests, and technical claims. Findings need evidence, and the review should offer a way to address the issue.

What review modes does brutal-honesty-review provide?

Linus focuses on technical errors, Ramsay assesses quality, and Bach examines questionable practices, certifications, and vendor claims.

Source text

SKILL.md · MIT
---
name: brutal-honesty-review
description: "Unvarnished technical criticism combining Linus Torvalds' precision, Gordon Ramsay's standards, and James Bach's BS-detection. Use when code/tests need harsh reality checks, certification schemes smell fishy, or technical decisions lack rigor. No sugar-coating, just surgical truth about what's broken and why."
category: quality-review
priority: high
tokenEstimate: 1200
agents: [qe-code-reviewer, qe-quality-gate, qe-security-auditor]
implementation_status: optimized
optimization_version: 1.0
last_optimized: 2025-12-03
dependencies: []
quick_reference_card: true
tags: [code-review, honesty, critical-thinking, technical-criticism, quality]
trust_tier: 2
validation:
  schema_path: schemas/output.json
  validator_path: scripts/validate-config.json
  eval_path: evals/brutal-honesty-review.yaml
---
# Brutal Honesty Review

<default_to_action>
When brutal honesty is needed:
1. CHOOSE MODE: Linus (technical), Ramsay (standards), Bach (BS detection)
2. VERIFY CONTEXT: Senior engineer? Repeated mistake? Critical bug? Explicit request?
3. STRUCTURE: What's broken → Why it's wrong → What correct looks like → How to fix
4. CITE EVIDENCE for every finding (file:line, command + output, test result, quote)
5. ATTACK THE WORK, not the worker
6. ALWAYS provide actionable path forward

**Quick Mode Selection:**
- **Linus**: Code is technically wrong, inefficient, misunderstands fundamentals
- **Ramsay**: Quality is subpar compared to clear excellence model
- **Bach**: Certifications, best practices, or vendor hype need reality check

**Calibration:**
- Level 1 (Direct): "This approach is fundamentally flawed because..."
- Level 2 (Harsh): "We've discussed this three times. Why is it back?"
- Level 3 (Brutal): "This is negligent. You're exposing user data because..."

**DO NOT USE FOR:** Junior devs' first PRs, demoralized teams, public forums, low psychological safety

## Evidence Rule (No Findings Quota)
Every finding must cite evidence: a file and line, a command and its output, a test result, or a quote from the PR or docs. A criticism without evidence is dropped or explicitly labeled a hypothesis or open question. There is no minimum number of findings: if the review finds nothing serious, say so, list what was checked and how, and state your confidence. Inventing findings to meet a count is completion theater in reverse and erodes the review's credibility. If a clean result looks suspicious for the size or risk of the change, look deeper, but report only what the evidence shows.
</default_to_action>

## Quick Reference Card

### When to Use
| Context | Appropriate? | Why |
|---------|-------------|-----|
| Senior engineer code review | ✅ Yes | Can handle directness, respects precision |
| Repeated architectural mistakes | ✅ Yes | Gentle approaches failed |
| Security vulnerabilities | ✅ Yes | Stakes too high for sugar-coating |
| Evaluating vendor claims | ✅ Yes | BS detection prevents expensive mistakes |
| Junior dev's first PR | ❌ No | Use constructive mentoring |
| Demoralized team | ❌ No | Will break, not motivate |
| Public forum | ❌ No | Public humiliation destroys trust |

### Three Modes

| Mode | When | Example Output |
|------|------|----------------|
| **Linus** | Code technically wrong | "You're holding the lock for the entire I/O. Did you test under load?" |
| **Ramsay** | Quality below standards | "12 tests and 10 just check variables exist. Where's the business logic?" |
| **Bach** | BS detection needed | "This cert tests memorization, not bug-finding. Who actually benefits?" |

---

## The Criticism Structure

```markdown
## What's Broken
[Surgical description - specific, technical]

## Why It's Wrong
[Technical explanation, not opinion]

## What Correct Looks Like
[Clear model of excellence]

## How to Fix It
[Actionable steps, specific to context]

## Why This Matters
[Impact if not fixed]
```

---

## Mode Examples

### Linus Mode: Technical Precision

```markdown
**Problem**: Holding database connection during HTTP call

"This is completely broken. You're holding a database connection
open while waiting for an external HTTP request. Under load, you'll
exhaust the connection pool in seconds.

Did you even test this with more than one concurrent user?

The correct approach is:
1. Fetch data from DB
2. Close connection
3. Make HTTP call
4. Open new connection if needed

This is Connection Management 101. Why wasn't this caught in review?"
```

### Ramsay Mode: Standards-Driven Quality

```markdown
**Problem**: Tests only verify happy path

"Look at this test suite. 15 tests, 14 happy path scenarios.
Where's the validation testing? Edge cases? Failure modes?

This is RAW. You're testing if code runs, not if it's correct.

Production-ready covers:
✓ Happy path (you have this)
✗ Validation failures (missing)
✗ Boundary conditions (missing)
✗ Error handling (missing)
✗ Concurrent access (missing)

You wouldn't ship code with 12% coverage. Don't merge tests
with 12% scenario coverage."
```

### Bach Mode: BS Detection

```markdown
**Problem**: ISTQB certification required for QE roles

"ISTQB tests if you memorized terminology, not if you can test software.

Real testing skills:
- Finding bugs others miss
- Designing effective strategies for context
- Communicating risk to stakeholders

ISTQB tests:
- Definitions of 'alpha' vs 'beta' testing
- Names of techniques you'll never use
- V-model terminology

Before making the cert a hiring requirement, ask for the evidence:
do certified teams in this organization find more important bugs or
ship fewer escapes? If nobody can show that, the requirement is
filtering on memorization, not on testing skill."
```

---

## Assessment Rubrics

### Code Quality (Linus Mode)

| Criteria | Failing | Passing | Excellent |
|----------|---------|---------|-----------|
| Correctness | Wrong algorithm | Works in tested cases | Proven across edge cases |
| Performance | Naive O(n²) | Acceptable complexity | Optimal + profiled |
| Error Handling | Crashes on invalid | Returns error codes | Graceful degradation |
| Testability | Impossible to test | Can mock | Self-testing design |

### Test Quality (Ramsay Mode)

| Criteria | Raw | Acceptable | Michelin Star |
|----------|-----|------------|---------------|
| Coverage | <50% branch | 80%+ branch | 95%+ mutation tested |
| Edge Cases | Only happy path | Common failures | Boundary analysis complete |
| Stability | Flaky (>1% failure) | Stable but slow | Deterministic + fast |

### BS Detection (Bach Mode)

| Red Flag | Evidence | Impact |
|----------|----------|--------|
| Cargo Cult Practice | "Best practice" with no context | Wasted effort |
| Certification Theater | Required cert unrelated to skills | Filters out thinkers |
| Vendor Lock-In | Tool solves problem it created | Expensive dependency |

---

## Agent Integration

```typescript
// Brutal honesty code review
await Task("Code Review", {
  code: pullRequestDiff,
  mode: 'linus',  // or 'ramsay', 'bach'
  calibration: 'direct',  // or 'harsh', 'brutal'
  requireActionable: true,
  requireEvidence: true   // every finding cites file:line, output, or quote
}, "qe-code-reviewer");

// BS detection for vendor claims
await Task("Vendor Evaluation", {
  claims: vendorMarketingClaims,
  mode: 'bach',
  requireEvidence: true
}, "qe-quality-gate");
```

---

## Agent Coordination Hints

### Memory Namespace
```
aqe/brutal-honesty/
├── code-reviews/*     - Technical review findings
├── bs-detection/*     - Vendor/cert evaluations
└── calibration/*      - Context-appropriate levels
```

### Fleet Coordination
```typescript
const reviewFleet = await FleetManager.coordinate({
  strategy: 'brutal-review',
  agents: [
    'qe-code-reviewer',    // Technical precision
    'qe-security-auditor', // Security brutality
    'qe-quality-gate'      // Standards enforcement
  ],
  topology: 'parallel'
});
```

---

## Related Skills
- [code-review-quality](../code-review-quality/) - Diplomatic version
- [context-driven-testing](../context-driven-testing/) - Foundation for Bach mode
- [sherlock-review](../sherlock-review/) - Evidence-based investigation

---

## Remember

**Brutal honesty eliminates ambiguity but has costs.** Use sparingly, only when necessary, and always provide actionable paths forward. Attack the work, never the worker.

**The Brutal Honesty Contract**: Get explicit consent. "I'm going to give unfiltered technical feedback. This will be direct, possibly harsh. The goal is clarity, not cruelty."

© proffesor-for-testing · MIT · proffesor-for-testing/agentic-qe

Similar skills

All skills for Code review and refactoring →

From the same set73

The whole set →
regression-testing regression-testing selects affected tests using git diff and impact analysis instead of running the whole suite. Cuts commit test execution down to 5–10 minutes. CX Codex +1 339installs test-automation-strategy The test-automation-strategy skill shapes a test automation plan, fixes test-pyramid imbalance, and connects checks to CI/CD workflows. CX Codex +1 261installs technical-writing Sets rules for technical writing: lead with value, back claims with examples and sourced numbers, cut filler words. Triggers when drafting blog posts, docs, or tutorials. CX Codex +1 209installs test-design-techniques test-design-techniques applies systematic test design: boundary value analysis, equivalence partitioning, decision tables, state transition testing, and combinatorial coverage. CX Codex +1 208installs mobile-testing mobile-testing — a skill for testing iOS and Android apps: gestures, sensors, permissions, device fragmentation, and performance. CX Codex +1 177installs n8n-workflow-testing-fundamentals n8n-workflow-testing-fundamentals — a skill for testing n8n workflows: validates structure, nodes, data flows, error handling, and execution performance of automation workflows. CX Codex +1 176installs n8n-security-testing n8n-security-testing scans n8n workflows for leaked credentials, checks credential encryption, and tests webhook authentication. CX Codex +1 176installs visual-testing-advanced visual-testing-advanced runs pixel-level visual regression suites, responsive viewport checks, and AI diff analysis to catch broken layouts early. CX Codex +1 163installs

Project sponsors

Companies that keep this analytics open