Clean Code Principles

A language-agnostic reference for core software design principles that you can drop into code reviews, architecture discussions, or refactoring sessions. Covers SOLID, DRY, KISS, YAGNI, and common design patterns like repository, factory, and strategy. The skill is organized by priority (SOLID and core principles first, naming conventions later) and outputs findings in a clean file:line format. About half the categories are implemented with detailed rule files, the rest are planned. This is basically a structured cheat sheet of Robert Martin and Gang of Four principles that Claude can reference when you're discussing code quality. Worth having around if you find yourself explaining the same design concepts repeatedly or want consistent vocabulary for architecture decisions.

skills.sh installs: 1.9K
GitHub stars: 102
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add asyrafhussin/agent-skills --skill clean-code-principles --agent claude-code

Installs into .claude/skills of the current project.

Files

Clean Code Principles

Fundamental software design principles, SOLID, design patterns, and clean code practices. Language-agnostic guidelines for writing maintainable, scalable software.

When to Apply

Reference these guidelines when:

Designing new features or systems
Reviewing code architecture
Refactoring existing code
Discussing design decisions
Improving code quality

Rule Categories by Priority

Priority	Category	Impact	Prefix
1	SOLID Principles	CRITICAL	`solid-`
2	Core Principles	CRITICAL	`core-`
3	Design Patterns	HIGH	`pattern-`
4	Code Organization	HIGH	`org-`
5	Naming & Readability	MEDIUM	`name-`
6	Functions & Methods	MEDIUM	`func-`
7	Comments & Documentation	LOW	`doc-`