Code Quality

This walks you through clean code principles, SOLID design patterns, and practical code review checklists with side-by-side examples of what not to do and how to fix it. You get meaningful naming conventions, function design, when comments actually help versus when they're noise, and concrete implementations of each SOLID principle in TypeScript. The code review section includes a checklist covering correctness, design, and readability. It's most useful when you're refactoring legacy code, onboarding new developers who need to learn your standards, or during PR reviews when you need to articulate why something should change beyond just "this feels wrong."

skills.sh installs: 785
GitHub stars: 26
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add miles990/claude-software-skills --skill code-quality --agent claude-code

Installs into .claude/skills of the current project.

Files

Code Quality

Overview

Principles and practices for writing maintainable, readable, and reliable code.

Clean Code Principles

Meaningful Names

// ❌ Cryptic names
const d = new Date();
const u = getU();
const arr = data.filter(x => x.s === 'a');

// ✅ Descriptive names
const currentDate = new Date();
const currentUser = getCurrentUser();
const activeUsers = users.filter(user => user.status === 'active');

// ❌ Hungarian notation (outdated)
const strName = 'John';
const arrItems = [];
const bIsActive = true;

// ✅ Let the type system handle types
const name = 'John';
const items: Item[] = [];
const isActive = true;

Functions

// ❌ Does too much
function processUserData(userId: string) {
  const user = db.findUser(userId);
  const orders = db.findOrders(userId);
  const total = orders.reduce((sum, o) => sum + o.amount, 0);
  sendEmail(user.email, `Your total: ${total}`);
  updateAnalytics(userId, total);
  return { user, orders, total };
}

// ✅ Single responsibility
function getUser(userId: string): User {
  return db.findUser(userId);
}

function getUserOrders(userId: string): Order[] {
  return db.findOrders(userId);
}

SKILL.md on GitHub