Does it fix the code automatically?

No, it provides a structured analysis including diagrams, observations, and prioritized refactoring suggestions with trade-offs to guide manual improvements.

Is this for styling or linting?

No, it ignores naming and formatting to focus strictly on structural architecture and high-level system design.

How are findings presented?

Findings are presented with an ASCII dependency diagram, an observation of current behavior, a critical question about the design choice, a suggested alternative, and the potential impact of the change.

What does the verify-design-a skill actually do?

It performs an 'architecture review in hindsight,' analyzing existing code to find dependency issues, unnecessary abstractions, and module boundary errors.

Architectural Design Reviewer

Name: Architectural Design Reviewer
Author: JSai23

byJSai23

•

Developer Tools

Conducts deep architectural audits of existing codebases to identify structural weaknesses, dependency issues, and abstraction leaks.

The verify-design-a skill automates the process of architectural hindsight, allowing developers to critically evaluate a system's structure after implementation. It analyzes module boundaries, dependency graphs, and class designs to determine if the current abstraction level is justified or if simpler alternatives exist. By generating ASCII diagrams and structured findings (Observation, Question, Alternative, Impact), it provides a rigorous framework for refactoring decisions, ensuring that the code remains maintainable and aligned with sound architectural principles rather than just superficial style.

Key Features

01Automated ASCII diagram generation for visualizing data flow and layer structure

02Structured refactoring roadmap with prioritized From/To candidates and trade-off analysis

03In-depth dependency analysis to identify circular references and hidden coupling

041 GitHub stars

05Abstraction auditing to determine if interfaces are earning their complexity

06Module structure assessment to ensure logical code grouping and clear boundaries

Use Cases

01Reviewing a newly completed feature to ensure it follows established architectural patterns

02Evaluating a legacy codebase before a major refactor to identify structural bottlenecks

03Assessing inherited code to understand dependency risks and modularity gaps

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jsai23/claude-tooling verify-design-a

For use in Claude.ai and ChatGPT

Download Skill