Simplify — Code Quality Review and Improvement

SkillAI & models

Review changed code for reuse, quality, and efficiency, then fix any issues found. Use after PDCA Check >= 90% or when code review is needed.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Simplify — Code Quality Review and Improvement skill

What this skill tells your AI

The instructions your AI receives, as published by ww-w-ai/bkit-gemini in skills/simplify/SKILL.md and read by ahel’s review.

Review changed code for reuse, quality, and efficiency, then fix any issues found.

When to Use

  • After PDCA Check phase reaches >= 90% match rate.
  • When code review is needed before merging.
  • When refactoring is requested.

4-Step Workflow

Step 1: Collect Changed Files

Run git diff --name-only (and git diff --cached --name-only for staged files) to identify all recently changed files.

Filter to relevant source files only (exclude lockfiles, generated files, build artifacts).

Output: List of files to review.

Step 2: Analyze Each File

For each changed file, analyze for:

CategoryWhat to Look For
Duplicate codeRepeated logic that can be extracted into shared functions
Unnecessary complexityNested conditionals, long functions, over-engineering
Naming improvementsUnclear variable/function names, inconsistent conventions
Unused codeDead imports, unreachable branches, commented-out blocks
Error handlingMissing try/catch, unhandled edge cases
PerformanceUnnecessary loops, redundant operations, missing caching

Output: Issue table per file.

Step 3: Apply Improvements

For each identified issue:

  1. Apply the fix automatically using replace tool.
  2. Ensure the fix does not change external behavior.
  3. Preserve existing test coverage.

Rules:

  • Do NOT change public API signatures without confirmation.
  • Do NOT remove code that appears unused if it is exported.
  • Keep changes minimal and focused.

Step 4: Output Change Summary

Present a summary table of all changes made:

FileChange TypeBeforeAfterImpact
...Dedup3 copies1 shared function-20 lines
...NamingtmpuserSessionReadability
...Dead codeUnused importRemovedClean

Final output:

  • Total files reviewed
  • Total issues found
  • Total issues fixed
  • Lines added / removed

References

  • Use project's existing linting rules and conventions.
  • Respect .eslintrc, .prettierrc, or equivalent config files.

Signals

GitHub stars
65
Forks
16
Last commit
May 2026
Advanced
Catalog kind
skill
Gateway key
simplify-ww-w-ai
Source
github.com/ww-w-ai/bkit-gemini