refactor-challenge

Guide developers to identify code smells through Socratic questioning.

Updated Aug 23, 2026

Search Tags:#refactor #socratic #code-review #mentorship #code-smells #developer-training

Ready to run

npx skills add https://github.com/thisguymartin/ai-native-dev --skill refactor-challenge

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: refactor-challenge
Source: https://github.com/thisguymartin/ai-native-dev/tree/main/.gemini/skills/refactor-challenge
Command: npx skills add https://github.com/thisguymartin/ai-native-dev --skill refactor-challenge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many developers receive direct fixes instead of learning to recognize and reason about code quality problems; this Skill trains developers to spot code smells, understand their impact, and devise improvements themselves through guided questions rather than automated refactors.

Core Features & Use Cases

Socratic tutoring: Identifies specific code smells with line references, explains why they matter, and challenges the developer to propose fixes before revealing recommendations.
Structured clarification protocol: Forces scope, difficulty, and focus selection so feedback is targeted and appropriate for learning goals.
Use cases: Pair-programming practice, onboarding junior engineers, writing better code reviews, and preparing developers to perform maintainable refactors.

Quick Start

Ask the skill to analyze src/utils/helpers.ts at intermediate difficulty focusing on readability and performance.

Frequently Asked Questions about refactor-challenge

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

FAQPage Schema

How does Socratic questioning help identify code smells during a code review?▼

Socratic questioning identifies code smells by guiding developers to reason about naming, structure, and performance themselves, rather than providing automated refactors. It challenges you to propose fixes before revealing recommendations.

Can I use this to train junior developers on code readability and error handling?▼

Yes, you can use this to train junior developers on readability and error handling. It targets single files, functions, or small modules, making it suitable for pair-programming practice and onboarding sessions.

How do I get targeted feedback on a specific file's structure and testability?▼

To get targeted feedback on structure and testability, provide a code snippet or file path and select your desired difficulty and focus areas. The mandatory clarification protocol ensures feedback matches your learning goals.

What is the best way to learn refactoring without receiving direct code fixes?▼

The best way to learn refactoring without direct fixes is through guided mentorship that points out specific code smells with line references and explains their impact. This approach trains you to devise improvements independently.

Does this approach automatically refactor my code snippets or modules?▼

No, this approach never performs automatic refactors on your code snippets or modules. It focuses entirely on guided questioning and coaching to help you recognize and resolve code quality problems yourself.

What code quality dimensions can I focus on when analyzing a module?▼

When analyzing a module, you can focus on naming, structure, performance, error handling, and testability. You must select your focus areas during the clarification protocol to receive appropriate feedback.