skills.rest
vonchristian
vonchristianCOMMUNITY
Explore all skills by this author →
GitHub

socratic-review

Guide structured code reviews by identifying code smells and suggesting refactoring moves.

Updated Jul 10, 2026
Search Tags:#developer tools#code review#refactoring#software quality#Socratic method
One-click install
npx skills add https://github.com/vonchristian/sirib --skill socratic-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: socratic-review
Source: https://github.com/vonchristian/sirib/tree/main/.opencode/skills/socratic-review
Command: npx skills add https://github.com/vonchristian/sirib --skill socratic-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill facilitates a structured, Socratic code review process, helping developers identify and address code smells through targeted questions and refactoring suggestions.

Core Features & Use Cases

  • Socratic Review Process: Guides through a silent assessment, user-led exploration, and guided refactoring.
  • Issue Identification: Assists in pinpointing code smells like Feature Envy, Divergent Change, and Long Method.
  • Refactoring Guidance: Provides a sequence of refactoring moves tailored to the identified issues.
  • Use Case: Use this Skill to conduct a code review on a new feature and systematically improve its structure and maintainability.

Quick Start

Start a socratic code review session on your codebase by running the socratic-review skill.

Frequently Asked Questions about socratic-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use the Socratic method for code review and refactoring?▼

The Socratic method for code review guides you through silent assessment, user-led exploration, and guided refactoring to identify code smells and systematically improve software quality.

What are common code smells to look for during a structured code review?▼

During a structured code review, you should look for common code smells like Feature Envy, Divergent Change, and Long Method to determine where refactoring is needed.

How do I get step-by-step refactoring guidance for my codebase?▼

You get step-by-step refactoring guidance by starting a Socratic review session, which provides a targeted sequence of refactoring moves tailored to the specific code smells identified.

Do I need prior knowledge of refactoring techniques to use a Socratic code review?▼

Yes, a Socratic code review requires an understanding of common code smells and refactoring techniques to effectively pinpoint issues and guide the systematic improvement of your codebase.

What is the best way to systematically improve code maintainability for a new feature?▼

The best way to systematically improve maintainability is conducting a Socratic code review on the new feature, using targeted questions to identify structural issues and apply precise refactoring moves.

When should I not use a Socratic code review approach?▼

You should avoid a Socratic code review if your codebase does not require systematic improvement, or if you lack an understanding of common code smells and refactoring techniques needed for the process.

Related Skills

Explore More Software Engineering Skills→
bsenebsene
1

refactoring

Detect code smells and apply refactoring techniques to improve code clarity.

Community
Advanced
j-showj-show

review-helper

Review git diffs, apply fixes, and verify with pnpm check and test commands.

Official
Advanced
Next-ofkinNext-ofkin
1

code-refactoring-refactor-clean

Analyze code for smells and SOLID violations, then generate a prioritized refactoring plan.

Community
Advanced
jakerbrownjakerbrown
1

review-r

Review R scripts for issues and coding standards, generating markdown reports.

Community
Intermediate