@ubuligan/review-guru
v1.1.0
Published
Analyzes project source files for code smells and refactoring opportunities based on principles from refactoring.guru. Produces a refactor-report.md in the project root listing all detected issues and a prioritized, step-by-step refactoring plan. Use when
Downloads
0
Maintainers
Readme
review-guru
Analyzes project source files for code smells and refactoring opportunities based on principles from refactoring.guru. Writes a refactor-report.md to your project root with all findings and a prioritized step-by-step refactoring plan.
Install
npx @ubuligan/review-guruThen restart Claude Code to pick up the skill.
How to use
/review-guru — full project audit
/review-guru
/review-guru --diff # scan only files changed vs main branchClaude will:
- Map the project — discover all source files, exclude generated/dependency directories
- Detect framework — if React/Next.js, run bulletproof-react architecture audit + React component smell checks
- Analyze for code smells — check every file against the full refactoring.guru catalogue
- Score and prioritize — rank findings as High / Medium / Low severity
- Write
refactor-report.md— full findings table + phased refactoring plan with effort estimates - Update
refactor-history.md— one-line summary appended per run so you can track progress
/diff-check — instant diff review
/diff-check # review all uncommitted changes
/diff-check --staged # review only staged changesClaude will:
- Read
git diff— parse only the lines you actually changed - Analyze changed hunks — code smells + React component issues on new/modified lines only
- Print findings in chat — no report file, immediate feedback
- Severity gate — warns if High issues detected before you commit
License
MIT © 2026 Javid Salimov
