lightweight-design-analysis

Analyze code modules across eight design dimensions and generate structured reports with file:line references.

334|43|Updated Nov 14, 2025
One-click install
npx skills add https://github.com/NTCoding/claude-skillz --skill lightweight-design-analysis-ntcoding
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lightweight-design-analysis
Source: https://github.com/NTCoding/claude-skillz/tree/main/lightweight-design-analysis
Command: npx skills add https://github.com/NTCoding/claude-skillz --skill lightweight-design-analysis-ntcoding

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineers assess and improve code design quality by evaluating naming, object calisthenics, coupling & cohesion, immutability, domain integrity, type system, simplicity, and performance across a module or class. It delivers evidence-based findings with file:line references and concrete, actionable recommendations to guide refactoring and design improvements.

Core Features & Use Cases

  • Systematic evaluation across 8 dimensions (Naming, Object Calisthenics, Coupling & Cohesion, Immutability, Domain Integrity, Type System, Simplicity, Performance)
  • Evidence-based findings with exact file:line references and sample code before/after suggestions
  • Structured design-review report integrated with TDD/refactor workflows

Quick Start

  • Analyze a single class or module, e.g., Order.ts or UserService.ts, to surface design improvement opportunities.
  • Run the lightweight-design-analysis protocol to generate a structured findings report

Frequently Asked Questions about lightweight-design-analysis

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

FAQPage Schema
How do I analyze code for design quality issues during a refactoring?

This skill analyzes code design quality by evaluating modules across eight dimensions, including naming, object calisthenics, and domain integrity. It generates a structured report with file:line references and actionable recommendations to guide refactoring.

What is object calisthenics and how does it apply to clean code review?

Object calisthenics is a set of coding principles evaluated during design analysis to improve encapsulation and domain modeling. It is applied during code reviews to enforce Tell, Don't Ask patterns and strengthen immutability.

Does this design analysis tool support domain-driven design evaluation?

Yes, the design analysis supports domain-driven design by specifically evaluating domain integrity. It assesses how well modules model domain logic and provides concrete before and after code examples to improve encapsulation.

How do I check my class for coupling and cohesion problems?

You check your class for coupling and cohesion problems by running a module-level design evaluation. This surfaces evidence-based findings with exact file references, helping you identify tight coupling and low cohesion for targeted improvements.

What is the best way to find encapsulation violations in a TypeScript module?

The best way to find encapsulation violations is to analyze the module against object calisthenics and domain integrity dimensions. This evaluation produces concrete before and after code suggestions to fix leaking domain logic.

Can I use this for code review on a single class or do I need a whole module?

You can use this design analysis for a single class or an entire module. The evaluation operates on the class or module level, producing a structured findings report that integrates directly into your code review workflow.