software-principles

Identify SOLID principle violations in object-oriented code and propose refactoring steps.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/joleques/northstar-ai --skill software-principles-joleques
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: software-principles
Source: https://github.com/joleques/northstar-ai/tree/main/.codex/skills/software-principles
Command: npx skills add https://github.com/joleques/northstar-ai --skill software-principles-joleques

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides AI in analyzing code to identify violations of core software design principles (SOLID, OO) and to propose simple, pragmatic corrections that maintain clarity and maintainability.

Core Features & Use Cases

  • Detection of violations across SOLID principles (SRP, OCP, LSP, ISP, DIP) and OO design best practices.
  • Generation of concrete refactoring suggestions with minimal, pragmatic changes suitable for real-world codebases.
  • Suitable for code reviews, junior-to-senior developer guidance, and automated coaching in codebases of varying sizes.

Quick Start

Analyze the attached codebase for SOLID violations and propose concrete refactoring steps.

Frequently Asked Questions about software-principles

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

FAQPage Schema
How do I analyze code for SOLID principle violations?

To analyze code for SOLID principle violations, the skill reviews object-oriented structures like classes and interfaces to pinpoint SRP, OCP, LSP, ISP, and DIP infractions. It evaluates relationships during design reviews to identify areas needing correction.

What is the best way to refactor code that breaks object-oriented design principles?

Refactoring code that breaks object-oriented design principles is handled by providing structured guidance and actionable recommendations. It references established patterns to suggest minimal, pragmatic corrections that maintain clarity and maintainability in real-world codebases.

Can I use this for code reviews across different programming languages?

Yes, you can use this for code reviews across different programming languages. The analysis is applicable to object-oriented projects across various languages and architectures, making it suitable for automated coaching and guidance in diverse codebases.

When do I need to check my codebase for SOLID and OO design violations?

You need to check your codebase for SOLID and OO design violations during typical design review scenarios or when guiding junior developers. It helps detect structural flaws and recommends pragmatic improvements to sustain long-term maintainability.

Does this tool suggest design patterns to fix specific principle violations?

Yes, the tool suggests design patterns to fix specific principle violations. It references established software principles and related patterns to guide refactoring decisions, ensuring the recommended code changes are both pragmatic and structurally sound.