CtrlK
BlogDocsLog inGet started
Tessl Logo

vanity-engineering-review

Reviews codebases, architectures, PRs, and technical plans for vanity engineering — code and systems built for the developer's ego, resume, or intellectual pleasure rather than delivering user or business value. Triggers on: "review this code", "is this over-engineered", "code review", "architecture review", "complexity audit", "vanity check", "is this necessary", "simplify this", "tech debt review", or any request to evaluate whether code or architecture is justified by actual requirements. Also trigger when the user shares a codebase and asks for feedback, when discussing framework/library choices, when reviewing PRs, or when someone is debating whether to refactor or rebuild. Nudge activation when you detect patterns of unnecessary abstraction, premature optimization, or resume-driven technology choices in code the user shares — even if they haven't asked for a vanity review.

90

Quality

88%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Discovery

92%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong skill description with excellent specificity and comprehensive trigger coverage. It clearly defines both what the skill does and when to use it, including proactive activation conditions. The main weakness is that several trigger terms ('code review', 'simplify this', 'tech debt review') are generic enough to conflict with other code review or refactoring skills, though the vanity engineering framing does help differentiate it.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: reviews codebases, architectures, PRs, and technical plans. Clearly defines the specific lens of evaluation (vanity engineering) and names concrete patterns like unnecessary abstraction, premature optimization, and resume-driven technology choices.

3 / 3

Completeness

Clearly answers both 'what' (reviews code/architecture for vanity engineering patterns) and 'when' (explicit trigger phrases, contextual triggers like sharing a codebase for feedback, and even proactive nudge activation conditions). The 'Triggers on:' clause serves as an explicit and thorough 'Use when' equivalent.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'review this code', 'is this over-engineered', 'code review', 'architecture review', 'complexity audit', 'simplify this', 'tech debt review', 'is this necessary'. These are highly natural phrases users would actually type.

3 / 3

Distinctiveness Conflict Risk

While the vanity engineering angle is distinctive, many trigger terms like 'code review', 'architecture review', 'simplify this', and 'tech debt review' are very generic and would likely conflict with general code review or refactoring skills. The specific niche is clear but the broad triggers create overlap risk.

2 / 3

Total

11

/

12

Passed

Implementation

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a strong, well-structured skill that provides highly actionable guidance for a nuanced review task. Its main weakness is moderate verbosity — philosophical framing and cognitive bias explanations add tokens without adding capability for Claude. The workflow is exceptionally clear, the output format is concrete and specific, and the progressive disclosure to reference files is well-executed.

Suggestions

Trim the philosophical/explanatory prose (e.g., 'Kill Criteria Philosophy' paragraph about sunk cost and addition bias, 'Core Premise' section) — Claude doesn't need motivation for why vanity engineering is bad, just how to detect and report it.

The 'Integration with Negentropy Lens' section could be reduced to 2-3 bullet points; the current framing restates concepts already covered in the skill.

DimensionReasoningScore

Conciseness

The skill is well-written but verbose in places. The 'Kill Criteria Philosophy' section explaining human cognitive biases (sunk cost, addition bias) is unnecessary context for Claude. The 'Core Premise' philosophical framing and some of the explanatory prose could be tightened significantly. However, most content does earn its place — the diagnostic lenses, severity scale, and output template are all substantive.

2 / 3

Actionability

The skill provides highly concrete, executable guidance: a structured 4-phase review process, a specific severity scale (V0-V3), a detailed output template with exact sections and examples, 7 named diagnostic lenses with specific test questions, and tiered kill criteria with concrete threshold examples. The output format is copy-paste ready and the review steps are unambiguous.

3 / 3

Workflow Clarity

The 4-phase process is clearly sequenced (Establish Requirements → Detection Scan → Vanity Score → Kill Criteria Generation), with Phase 1 explicitly serving as a validation anchor before any analysis begins. Each phase has clear inputs and outputs, and the structured assessment template provides an explicit checklist. The requirement anchor step prevents the review from proceeding without grounding.

3 / 3

Progressive Disclosure

The skill appropriately references external files for detailed content: 'references/detection-patterns.md' for detection patterns and 'references/kill-criteria-template.md' for the full kill criteria template. These are one-level-deep, clearly signaled references. The main file serves as a comprehensive overview with the right level of detail inline, delegating catalog-style content to reference files.

3 / 3

Total

11

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
bencium/bencium-marketplace
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.