What happens if I don't have existing documentation?

The skill will identify the changes and ask if you would like a general code review without specific reference to architectural documentation or if you can point it to a relevant feature spec.

Can I review specific git branches with this skill?

Yes, you can provide a branch name as an argument, and the skill will perform a git diff against the main branch to identify changes that need reviewing.

Is this skill part of a larger ecosystem?

Yes, it is part of the Katachi plugin suite and works in conjunction with the framework-core to maintain consistent workflow principles across different tasks.

Does it provide suggestions for fixing the issues it finds?

Absolutely. For every issue identified, the skill explains the rationale based on your specs and provides a concrete fix recommendation that it can optionally apply for you.

How does the skill know which architectural rules to follow?

The skill scans your repository for documentation in specific locations like docs/architecture/ for ADRs and docs/design/ for design patterns to ensure the code complies with your team's decisions.

Katachi Code Review

Name: Katachi Code Review
Author: asermax

byasermax

•

协作工具

Validates code changes against architectural decisions, design patterns, and feature specifications to ensure pattern compliance.

The Katachi Code Review skill automates the complex task of ensuring new code aligns with a project's established technical standards and functional requirements. By analyzing specific branches, files, or uncommitted changes, it cross-references source code with internal Architectural Decision Records (ADRs) and design documentation. The skill identifies deviations from patterns, flags critical bugs, and suggests improvements, providing a structured report categorized by severity. It serves as an intelligent gatekeeper that helps maintain codebase consistency and prevents technical debt by enforcing compliance with project-specific design principles.

主要功能

011 GitHub stars

02Automated ADR and design pattern compliance checking

03Direct integration with project-specific feature specs and design docs

04Severity-based issue reporting from critical bugs to minor suggestions

05Multi-scope reviews for branches, specific files, or uncommitted diffs

06Interactive fix application for identified architectural violations

使用场景

01Validating local changes against project standards before submitting a pull request

02Enforcing architectural consistency across large teams using ADRs and design indexes

03Conducting deep-dive reviews of new features to ensure they match initial design specifications

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add asermax/claude-plugins review-code

For use in Claude.ai and ChatGPT

Download Skill