How does it estimate technical debt?

The skill calculates a severity score based on the type of violation and its architectural scope, then maps that score to an estimated time value required for future refactoring.

Does this skill block me from writing complex code?

No, the skill provides non-blocking 'nudges.' They are suggestions intended to make you pause and consider if a simpler approach exists, but they do not prevent you from proceeding with your implementation.

Can I customize the sensitivity of the detections?

Yes, you can use the '/yagni config' command to switch between strict, standard, and relaxed modes, or create a project-specific configuration file to whitelist certain patterns.

What is the YAGNI skill for Claude Code?

It is a specialized capability that monitors your coding session to identify unnecessary complexity, helping you adhere to YAGNI (You Aren't Gonna Need It) and KISS (Keep It Simple, Stupid) principles.

YAGNI & KISS Guard

Name: YAGNI & KISS Guard
Author: fyrsmithlabs

byfyrsmithlabs

0•

Developer Tools

Enforces code simplicity and prevents over-engineering by providing real-time nudges and complexity scoring during development.

The YAGNI & KISS Guard skill integrates directly into the Claude Code workflow to uphold the principles of 'You Aren't Gonna Need It' and 'Keep It Simple, Stupid.' It monitors for patterns of speculative generality, abstraction creep, and premature optimization, offering non-blocking suggestions and technical debt estimates to keep your codebase lean. By utilizing automated severity scoring and project-specific whitelists, it ensures that developers focus on solving current requirements rather than hypothetical future needs, ultimately reducing long-term maintenance costs and mental overhead.

Key Features

01Customizable sensitivity levels (Strict, Standard, Relaxed) and whitelisting

02Real-time detection of speculative abstractions and code smells

030 GitHub stars

04Technical debt quantification with estimated time-to-refactor metrics

05Automated severity scoring based on architectural impact and frequency

06Interactive dashboard for tracking simplicity trends across a project

Use Cases

01Preventing 'abstraction creep' during rapid prototyping and MVP development

02Auditing existing repositories for dead code and unnecessary design patterns

03Standardizing code simplicity across teams by providing objective complexity nudges

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add fyrsmithlabs/marketplace yagni

For use in Claude.ai and ChatGPT

Download Skill