Socratic Code Reviewer

What it does

The Socratic Code Reviewer provides high-seniority engineering feedback using a pedagogical approach. Instead of just pointing out errors, it uses the Socratic method—leadings with probing questions that expose underlying architectural flaws, concurrency issues, and edge cases. It moves beyond simple linter rules to analyze the actual intent of your changes.

Why use this skill

Most AI code reviews focus on syntax or style. This skill simulates a Lead Engineer who cares about long-term maintainability and correctness. It prioritizes high-impact issues like state ownership, boundary design, and failure paths over cosmetic changes. It doesn't just fix your code; it makes you a better developer by teaching you the 'why' behind the suggestions.

Supported workflows

• Pull Request Audits: Full structural analysis of diffs or new features.
• Draft Critiques: Early feedback on implementation logic before you commit.
• Architectural Guidance: Reviewing API and boundary designs for future scalability.
• Testing Strategy: Evaluation of test adequacy and coverage of edge cases.

The Output

You will receive a structured review ranked by severity. Each finding starts with a Socratic question intended to reveal the problem, followed by a detailed explanation and concrete code examples for the fix. The format adapts to your needs, whether you require a quick bulleted list or a formal audit report.

Next step

Once the review is done and the fixes are in, Developer Documentation Writer (paid) turns the code and the review findings into a quickstart, how-to guides and reference docs. It is also included in the Developer & AI Engineering Pack together with five other developer skills.