lightweight-design-analysis

Analyze class and module design across eight dimensions with file:line evidence.

Updated Dec 6, 2025
One-click install
npx skills add https://github.com/audunstrand/status-app --skill lightweight-design-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lightweight-design-analysis
Source: https://github.com/audunstrand/status-app/tree/main/.github/skills/design-analysis
Command: npx skills add https://github.com/audunstrand/status-app --skill lightweight-design-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineers systematically assess code design quality, surfacing design issues with concrete criteria and actionable findings.

Core Features & Use Cases

  • Eight-dimension design analysis: evaluates Naming, Object Calisthenics, Coupling & Cohesion, Immutability, Domain Integrity, Type System, Simplicity, and Performance.
  • Evidence-based findings: reports with file:line references and concrete code examples to support recommendations.
  • Workflow integration: complements lightweight implementation analysis by guiding focused refactors and architecture improvements.

Quick Start

Run the lightweight design-analysis protocol on a codebase to generate a Findings Report with prioritized recommendations.

Frequently Asked Questions about lightweight-design-analysis

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

FAQPage Schema
How do I perform a code design analysis to assess software architecture quality?

Code design analysis evaluates software architecture quality by assessing eight design dimensions, including Naming, Object Calisthenics, Coupling & Cohesion, Immutability, Domain Integrity, Type System, Simplicity, and Performance. It generates a Findings Report with prioritized recommendations.

What is the best way to find actionable refactoring suggestions for my codebase?

To find actionable refactoring suggestions, run a lightweight design analysis protocol on your codebase. It produces evidence-based findings with concrete file:line references and code examples to guide focused refactors.

Can static analysis tools evaluate code quality at the class and module level?

Yes, static analysis can evaluate code quality at the class and module level. This skill systematically assesses code flow and design dimensions to surface architecture issues with concrete criteria and actionable findings.

How does an architecture review identify coupling and cohesion issues?

An architecture review identifies coupling and cohesion issues by applying a structured protocol that understands code flow and evaluates specific design dimensions. It reports these issues using concrete file:line references and code examples.