design-principles

Identify design-quality issues in software projects and produce actionable refactoring plans.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/js-rom/Luis --skill design-principles-js-rom
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-principles
Source: https://github.com/js-rom/Luis/tree/main/.agents/skills/design-principles
Command: npx skills add https://github.com/js-rom/Luis --skill design-principles-js-rom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams identify design-quality issues in software projects and provides actionable guidance to improve structure, readability, testability, and maintainability.

Core Features & Use Cases

  • Analyze architecture, module boundaries, and class responsibilities to uncover cohesion/coupling flaws.
  • Propose concrete refactorings aligned with SRP, OCP, DIP, and SOLID, plus GoF pattern guidance.
  • Use Case: during a legacy-system review, generate a structured redesign plan that increases maintainability and testability.

Quick Start

Analyze the target project and produce a concrete, actionable refactoring plan following SOLID and DRY principles.

Frequently Asked Questions about design-principles

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

FAQPage Schema
How do I identify design-quality issues like coupling and cohesion flaws in my software architecture?

To identify design-quality issues, analyze your architecture, module boundaries, and class responsibilities to uncover cohesion and coupling flaws, then generate a structured refactoring plan to increase maintainability.

How do I refactor legacy code to improve testability and maintainability using SOLID principles?

Refactor legacy code by applying SOLID principles like SRP, OCP, and DIP to class responsibilities and module boundaries, producing a concrete, actionable redesign plan that increases both testability and maintainability.

What is the best way to structure a redesign plan for a legacy-system review?

The best way to structure a redesign plan is to analyze design artifacts, source code, and tests to identify architecture flaws, then output concrete improvement steps with rationale aligned to SOLID and DRY principles.

When do I need to apply GoF design patterns during software refactoring?

You need to apply GoF design patterns during refactoring when analyzing module boundaries and class responsibilities reveals structural flaws, using pattern guidance to propose concrete redesigns that improve testability and maintainability.

Does this software design analysis work for both module design and architecture reviews?

Yes, software design analysis applies to both architecture reviews and module design, evaluating source code and tests to identify design-quality issues and guide principled refactoring across different levels of your project.

What are the limitations of automated software design refactoring guidance?

Automated software design refactoring guidance requires analyzing complete design artifacts, source code, and tests to produce accurate results; without comprehensive project context, the actionable improvement steps may lack sufficient rationale for implementation.