skills.rest
Cygnusfear
CygnusfearCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

architectural-analysis

Diagnose architectural health issues in TypeScript/JavaScript codebases and output a structured findings report.

5|3|Updated Oct 23, 2025
Search Tags:#code quality#architecture#anti-patterns#refactoring#audit#duplication#dead code
One-click install
npx skills add https://github.com/Cygnusfear/claude-stuff --skill architectural-analysis
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architectural-analysis
Source: https://github.com/Cygnusfear/claude-stuff/tree/main/skills/architectural-analysis
Command: npx skills add https://github.com/Cygnusfear/claude-stuff --skill architectural-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Codebases inevitably accumulate dead code, duplicated functionality, architectural anti-patterns, and type issues, leading to increased technical debt and reduced maintainability. This skill performs a deep architectural audit to systematically identify and quantify these problems.

Core Features & Use Cases

  • Dead Code Detection: Identifies unused exports, functions, and files for removal, reducing codebase bloat.
  • Duplication Analysis: Flags exact, similar, and conceptual code duplication, highlighting areas for consolidation.
  • Anti-Pattern & Type Issue Identification: Detects God objects, circular dependencies, tight coupling, any usage, and unsafe type assertions.
  • Use Case: Conduct a quarterly health check on a large application to identify and quantify technical debt, providing a clear roadmap for refactoring initiatives and improving long-term maintainability.

Quick Start

Get directory structure

find . -type d -not -path "/node_modules/" -not -path "/.git/"

Find large files (potential God objects)

find . -name "*.ts" -exec wc -l {} + | sort -rn | head -20

Frequently Asked Questions about architectural-analysis

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

FAQPage Schema
How do I detect dead code and unused exports in a TypeScript codebase?▼

Dead code detection identifies unused exports, functions, and files across your TypeScript project. This skill scans entry points and module dependencies to flag unreachable code, letting you remove bloat and reduce codebase size systematically.

What's the best way to find code duplication in a large JavaScript project?▼

Duplication analysis flags exact, similar, and conceptual code patterns across your JavaScript codebase. The skill highlights consolidation opportunities, helping you eliminate redundant functionality and improve maintainability.

How can I identify architectural anti-patterns like God objects and circular dependencies?▼

Anti-pattern detection uncovers God objects, circular dependencies, tight coupling, unsafe `any` usage, and type assertions in your codebase. The skill provides file-level findings with refactoring recommendations prioritized by impact.

Can I use this to audit a TypeScript project and get a technical debt report?▼

Yes, this skill conducts deep architectural audits on TypeScript and JavaScript projects of any size. It outputs a structured findings report with file status, recommended refactors, and remediation priorities for quarterly health checks.

What type issues does this tool identify in TypeScript codebases?▼

Type issue identification flags unsafe type assertions and pervasive `any` usage patterns throughout your TypeScript project. These findings highlight areas where stricter typing improves reliability and reduce runtime errors.

Does this work for both small and large JavaScript applications?▼

This skill applies to TypeScript and JavaScript projects of varying sizes, from small modules to large applications. It scales across codebases to detect dead code, duplication, anti-patterns, and design problems systematically.

Related Skills

Explore More Software Engineering Skills→
DowwieDowwie
5

codebase-mapping

Map codebase structure and dependencies by parsing Python and JavaScript imports.

Community
Basic
hohai99hohai99

long-term-debt-tracker

Tracks, categorizes and prioritizes technical debt into actionable backlog items.

Community
Basic
realsigridjinrealsigridjin
20

build-fix

Fix TypeScript build and compilation errors with minimal changes.

Community
Intermediate
stronghunistronghuni
1

lie-deep

Detect lie code through static and dynamic analysis of the codebase.

Community
Advanced