What are 'architectural smells'?

Architectural smells are structural issues like circular dependencies, God modules, and shotgun surgery patterns that make code difficult to maintain, test, and deploy independently.

How does it detect hidden dependencies?

It uses temporal coupling analysis to find files that frequently change together despite having no explicit code imports, signaling shared state or implicit contracts.

Can it help identify team risks?

Yes, through ownership analysis, it identifies 'knowledge silos' with a low bus factor and 'fragmented ownership' where no clear maintainer exists for a module.

Do I need extra tools for this skill?

Yes, this skill requires the Omen CLI to be installed and available in your system's PATH to perform the data extraction and analysis.

What metrics does this skill analyze?

It measures CK metrics like LCOM (Lack of Cohesion), WMC (Weighted Methods per Class), and CBO (Coupling Between Objects) to assess class and module health.

Architectural Health Audit

Name: Architectural Health Audit
Author: panbanda

bypanbanda

•

보안 및 테스팅

Analyzes codebase structure to identify circular dependencies, low cohesion, and hidden technical debt hotspots.

The Architectural Health Audit skill enables developers to conduct deep structural reviews of their codebases using the Omen intelligence engine. It identifies critical architectural smells such as God modules, circular dependencies, and hidden temporal coupling that often lead to 'shotgun surgery' and high maintenance costs. By quantifying metrics like LCOM and CBO and visualizing ownership distribution, this skill helps teams make data-driven refactoring decisions, mitigate the 'bus factor' risk, and improve overall system maintainability through automated analysis.

주요 기능

01Calculates CK metrics including Lack of Cohesion (LCOM) and Coupling Between Objects (CBO)

02Analyzes ownership distribution to identify knowledge silos and fragmented maintenance risks

03Detects circular dependencies and 'God modules' using Omen graph analysis

049 GitHub stars

05Uncovers hidden temporal coupling between files lacking explicit import relationships

06Identifies architectural smells like hub modules and central connectors via Tarjan's SCC algorithm

사용 사례

01Conducting formal architecture reviews to ensure adherence to clean design patterns

02Performing technical debt assessments before major refactoring or migration projects

03Onboarding to a legacy codebase to map dependencies and identify critical structural risks

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add panbanda/omen audit-architecture

For use in Claude.ai and ChatGPT

Download Skill