How does it determine repository standards?

The skill analyzes existing patterns, naming conventions, and file structures within your repo to ensure new code matches the local style rather than introducing new conventions.

Will this skill automatically delete my code?

No, it provides a structured assessment and recommended removals based on the spec. You maintain full control over which suggestions to implement.

What counts as 'speculative code' to the Brevity Engineer?

Speculative code includes 'just-in-case' error handling for impossible states, config options for features not yet requested, and abstractions built for a single use case.

When should I trigger the Brevity Engineer skill?

Trigger this skill during the final phase of code writing, specifically during self-review or immediately before committing changes to ensure your PR is focused and minimal.

Brevity Engineer

Name: Brevity Engineer
Author: oxhagolli

byoxhagolli

•

Collaboration Tools

Enforces minimal, spec-aligned code changes by identifying scope creep and unnecessary abstractions during development.

Brevity Engineer is a specialized protocol designed to keep codebases lean and maintainable by ensuring every line of code serves a direct purpose outlined in the project specifications. It acts as a rigorous code review assistant that prevents 'just-in-case' coding, premature abstractions, and speculative feature additions that lead to technical debt. By matching existing repository patterns and questioning every addition, this skill helps developers deliver the smallest possible functional change while maintaining strict adherence to local coding standards and project requirements.

Key Features

011 GitHub stars

02Identification of premature abstractions and unnecessary function wrappers

03Scope creep detection to identify 'while I was here' additions

04Standardized Scope Review reporting for streamlined code assessments

05Removal of over-documented or redundant comments and types

06Repository pattern matching to ensure consistency with existing logic

Use Cases

01Automating peer reviews to enforce strict adherence to technical specifications

02Performing pre-commit self-reviews to minimize the footprint of a pull request

03Refactoring legacy code by identifying and removing redundant logic or infrastructure

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add oxhagolli/clawdskillz brevity-engineer

For use in Claude.ai and ChatGPT

Download Skill