brutal-honest

Analyze code, UI, and architecture with severity-tracked issues across tech stacks.

1|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/Gakuseei/brutal-honest-Skill --skill brutal-honest
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brutal-honest
Source: https://github.com/Gakuseei/brutal-honest-Skill/tree/main
Command: npx skills add https://github.com/Gakuseei/brutal-honest-Skill --skill brutal-honest

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Brutal-honest provides brutally honest, senior-level analysis of code, UI, and architecture across any tech stack, surfacing critical issues and actionable improvements.

Core Features & Use Cases

  • Stack-aware reviews across multiple technologies, with severity categories (CRITICAL, MAJOR, MEDIUM, MINOR).
  • Embedded references and checklists support consistent, traceable findings; supports a -check workflow to verify changes against git history.
  • Generates fix prompts and feature ideas; uses a skeptical pipeline to validate recommendations before suggesting changes.

Quick Start

Paste this SKILL.md as the system prompt in your agent to load embedded checks and begin a brutal, stack-aware review of your repository.

Frequently Asked Questions about brutal-honest

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I perform a code review that detects architecture and UI pattern issues across multiple tech stacks?

Stack-aware code review detects architecture and UI pattern issues by applying stack-specific checks across web, mobile, or game projects. It categorizes findings into CRITICAL, MAJOR, MEDIUM, and MINOR severities using embedded references and a skeptical validation pipeline.

Can I run a code review on a monorepo with multi-stack configurations?

Yes, you can review monorepos with multi-stack configurations. The review process enforces stack-specific checks and tracks critical issues across all included technologies, ensuring consistent analysis for complex project structures.

How does code review track issues against git history?

Code review tracks issues against git history using a -check workflow. This verifies code changes against previous commits, ensuring traceable recommendations and validating that architectural decisions align with the repository's evolution.

What is the best way to ensure traceable recommendations during an architecture review?

The best way to ensure traceable recommendations during an architecture review is to load embedded references and checklists. This enforces consistent, traceable findings by validating suggestions through a skeptical pipeline before outputting actionable fix prompts.

Does automated code review generate fix prompts for critical issues found?

Yes, automated code review generates fix prompts for critical issues found. After surfacing problems with clear severities, it uses a skeptical validation pipeline to ensure recommendations are accurate before providing actionable improvement prompts.

What are the limitations of using a skeptical pipeline for code review?

The limitation of a skeptical pipeline is that it validates recommendations before suggesting changes, which may filter out aggressive architectural shifts. It prioritizes traceable, high-confidence findings over speculative refactoring ideas.