This is a code review lens that asks the uncomfortable question: did you build this for users or for your LinkedIn profile? It scans codebases, PRs, and architecture docs for patterns like premature optimization, unnecessary abstractions, and resume-driven technology choices, then scores findings by severity and maintenance cost. The best part is the kill criteria framework it generates: hard rules for when to automatically delete features, review triggers that force you to justify keeping things, and soft-go metrics that make continuation something you have to earn rather than default into. Use it when evaluating refactors, reviewing architectures, or auditing why your three-person startup has a microservices mesh.

skills.sh installs
236
GitHub stars
267
last updated
Jun 3, 2026

Install

$ npx -y skills add bencium/bencium-claude-code-design-skill --skill vanity-engineering-review --agent claude-code

Installs into .claude/skills of the current project.

Files

Vanity Engineering Review

A diagnostic skill that identifies code, architecture, and technical decisions built to impress rather than to ship. Vanity engineering is entropy disguised as craftsmanship — it increases complexity without proportional capability gain, and it compounds maintenance cost while delivering zero additional user value.

Core Premise

The only legitimate purpose of engineering is to solve a problem someone actually has.

Everything else — elegant abstractions nobody traverses, microservices that serve one endpoint, custom frameworks that replicate existing tools, type systems more complex than the domain they model — is vanity. It may feel productive. It is not.

This skill does not oppose quality, rigour, or good engineering. It opposes engineering that exists to satisfy the builder rather than the user.

When to Apply This Skill

Apply this review to any of:

  • Codebase audits (full repo or specific modules)
  • Pull request reviews
  • Architecture proposals or RFCs
  • Technology selection decisions
  • Refactoring plans
  • "Should we rebuild this?" discussions
  • Post-mortems where complexity contributed to failure

The Review Process

Sponsors

Details

Repository
github.com/bencium/bencium-claude-code-design-skill
Categories
Git & Pull Requests, Code Review & Quality, Design & UI/UX
First seen
Jun 3, 2026

More from bencium/bencium-claude-code-design-skill

All 13
1existential-birds avatarpytest-code-reviewexistential-birds/beagleReviews pytest test code for async patterns, fixtures, parametrize, and mocking. Use when reviewing test_*.py files, checking async test functions, fixture usag232skills.sh installs
2cowork-os avatarlegal-contract-negotiation-reviewcowork-os/cowork-osAnalyze counterparty contract changes against agreement/schedules, flag conflicts, and produce severity-rated counterpositions.229skills.sh installs
3community-access avatargithub-analytics-scoringcommunity-access/accessibility-agentsScore repository health (0-100, A-F grades), priorities, and delta tracking. Includes velocity metrics, confidence levels, and bottleneck detection.225skills.sh installs
4existential-birds avatarsqlalchemy-code-reviewexistential-birds/beagleReviews SQLAlchemy code for session management, relationships, N+1 queries, and migration patterns. Use when reviewing SQLAlchemy 2.0 code, checking session lif225skills.sh installs
5manojbajaj95 avatarpr-specialistmanojbajaj95/claude-gtm-pluginExpert PR and media relations guidance for earned media, press coverage, and reputation building. Use when writing press releases, crafting media pitches, devel225skills.sh installs
6hairyf avatargithub-clihairyf/skillsGitHub CLI (gh) reference for repositories, issues, pull requests, Actions, projects, releases, gists, codespaces, and GitHub operations from the command line.212skills.sh installs