skills.rest
soham2008xyz
soham2008xyzCOMMUNITY
Explore all skills by this author →
Website𝕏@nonconformismGitHub

review-and-refactor

Review code against project guidelines and refactor while keeping tests passing.

Updated Jan 8, 2026
Search Tags:#code review#refactoring#coding standards#maintainability#technical debt#test verification
One-click install
npx skills add https://github.com/soham2008xyz/trade-tycoon --skill review-and-refactor-soham2008xyz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review-and-refactor
Source: https://github.com/soham2008xyz/trade-tycoon/tree/main/.agents/skills/review-and-refactor
Command: npx skills add https://github.com/soham2008xyz/trade-tycoon --skill review-and-refactor-soham2008xyz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps teams reduce technical debt by reviewing existing code against project-specific guidelines and improving structure and readability without breaking functionality.

Core Features & Use Cases

  • Guideline-driven review: Reads coding standards from .github/instructions/*.md and .github/copilot-instructions.md and applies them consistently during refactoring.
  • Maintainability-focused refactoring: Improves code cleanliness, structure, and best-practice alignment while keeping the existing files intact.
  • Regression safety: When tests exist, verifies that the refactored changes keep the test suite passing.

Quick Start

Ask the skill to review the repository codebase against the instructions in .github/instructions/*.md and .github/copilot-instructions.md, then refactor for clean, maintainable code while ensuring all existing tests still pass.

Frequently Asked Questions about review-and-refactor

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

FAQPage Schema
How do I refactor existing code to reduce technical debt without changing file structure?▼

To refactor existing code and reduce technical debt without altering file structure, this Skill reviews your repository against project-specific guidelines and applies safe refactors to improve maintainability while keeping files intact.

How does guideline-driven code review work with custom coding standards?▼

Guideline-driven code review works by reading custom coding standards from `.github/instructions/*.md` and `.github/copilot-instructions.md`, then consistently applying those project-specific rules during the refactoring process.

Can I run code refactoring without breaking existing test suites?▼

Yes, you can refactor code without breaking existing tests. When tests exist in the repository, this Skill performs regression safety verification to ensure the refactored changes keep the test suite passing.

What is the best way to improve code maintainability across an existing repository?▼

The best way to improve code maintainability across an existing repository is to perform guideline-aware reviews that target code cleanliness, structure, and best-practice alignment while preserving current functionality.

Do I need to define coding instructions before refactoring messy code?▼

You do not strictly need to define coding instructions, but having project-specific guidelines in `.github/instructions/*.md` allows the refactoring process to consistently apply your team's best practices and coding standards.

Related Skills

Explore More Software Engineering Skills→
BrunoAMSilvaBrunoAMSilva

review-and-refactor

Review and refactor source code using repository coding guidelines.

Community
Advanced
HomericIntelligenceHomericIntelligence
18

run-tests

Execute Mojo or Python test suites and generate validation reports.

Official
Basic
jackmcintyrejackmcintyre

python-refactoring

Analyze Python code for complexity, duplication, and best practices.

Community
Intermediate
AskTinNguyenAskTinNguyen

code-simplifier

Refine recently modified code to improve readability and maintainability.

Community
Intermediate