design-principles

Audit codebases against SOLID, DRY, YAGNI, and other design principles.

3|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/rshade/agent-skills --skill design-principles-rshade
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-principles
Source: https://github.com/rshade/agent-skills/tree/main/skills/design-principles
Command: npx skills add https://github.com/rshade/agent-skills --skill design-principles-rshade

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit codebases against well-known design principles: SOLID, DRY, YAGNI, KISS, Law of Demeter, Separation of Concerns, Composition over Inheritance, and the code-relevant 12-Factor subset. Scores findings by impact and effort, runs adversarial debate on contested violations, and generates a prioritized DESIGN_AUDIT.md. Use when reviewing code quality beyond what linters catch, assessing design health before a refactor, or onboarding to an unfamiliar codebase. Can be invoked standalone or delegated from tech-debt.

Core Features & Use Cases

  • Audit the codebase against established design principles to surface health issues.
  • Score findings by impact and effort, and run adversarial debates on contested violations.
  • Generate DESIGN_AUDIT.md with prioritized remediation recommendations.

Quick Start

Run the audit on your repository to generate DESIGN_AUDIT.md.

Frequently Asked Questions about design-principles

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

FAQPage Schema
How do I audit my codebase for SOLID, DRY, and KISS principle violations?

Code design audits evaluate your repository against established design principles like SOLID, DRY, and KISS. The process detects principle violations, scores findings by impact and effort, and generates a prioritized DESIGN_AUDIT.md report for remediation.

What is the best way to assess code design health before a major refactor?

Assessing code design health before a refactor requires auditing the codebase against core design principles. This surfaces structural issues missed by linters, scores findings by impact and effort, and outputs a prioritized DESIGN_AUDIT.md to guide remediation efforts.

Can I run a design principles audit on an unfamiliar codebase during onboarding?

Yes, you can run a design principles audit on an unfamiliar codebase during onboarding. It evaluates code against well-known principles like SOLID and Separation of Concerns, running adversarial debates on contested violations to generate a prioritized DESIGN_AUDIT.md.

Does the design audit check for Law of Demeter and Separation of Concerns violations?

Yes, the design audit checks for Law of Demeter and Separation of Concerns violations. It audits codebases against SOLID, DRY, YAGNI, KISS, Composition over Inheritance, and the code-relevant 12-Factor subset to surface design health issues.

How are contested design principle violations evaluated during a code review?

Contested design principle violations are evaluated through an adversarial debate mechanism during the audit. This process scores findings by impact and effort, resolving disputes to generate a prioritized DESIGN_AUDIT.md with clear remediation recommendations.

When should I use a design principles audit instead of standard static analysis tools?

Use a design principles audit instead of standard static analysis tools when reviewing code quality beyond what linters catch. It evaluates architectural design health against principles like SOLID and DRY, providing impact and effort scores for prioritized remediation.