Pre-Commit Design Review

关于

This skill provides an advisory layer of quality control for React and TypeScript codebases by identifying architectural and design flaws before they are committed. It categorizes findings into Design Debt, Readability Debt, and Polish Opportunities, helping developers avoid issues like primitive obsession, prop drilling, and poor accessibility. While it does not block commits, it offers actionable feedback and refactoring suggestions to ensure code remains maintainable, accessible, and aligned with feature-based architectural patterns.

主要功能

• Identifies design debt such as primitive obsession, tight coupling, and prop drilling
• Evaluates accessibility compliance including semantic HTML, ARIA attributes, and keyboard navigation
• Provides tiered advisory reports categorized by impact level (Design, Readability, or Polish)
• 1 GitHub stars
• Analyzes architectural patterns to ensure alignment with feature-based structures
• Assesses code readability and maintainability by identifying mixed abstractions and complex logic

使用场景

• Auditing existing TypeScript files for technical debt and architectural consistency
• Reviewing code for domain-specific best practices such as Zod validation and branded types
• Validating component design and accessibility before committing new React features