Back to Skills

review-and-refactor

Review and refactor code in your project according to defined instructions

30,356stars3,609forksUpdated 4/19/2026

Security Assessment

Safe(100/100)
Security Score100/100

About review-and-refactor

The 'review-and-refactor' skill is designed to assist software engineers by automating the review and refactoring of code in line with specified guidelines. This skill targets the challenge of ensuring that code adheres to best practices, remains clean, and is maintainable over time. By automating these steps, it eliminates manual effort, improves consistency across projects, and helps developers maintain high-quality code. It also provides a structured way to ensure coding standards are met and that the code is easier to understand, extend, and debug in the future.

Key capabilities of this skill include reviewing all the coding guidelines and instructions within a project, refactoring the code accordingly, and ensuring that tests pass after changes are made. The focus is on ensuring that the code is not only syntactically correct but also follows a consistent structure that promotes maintainability. This skill is particularly useful in long-term projects where maintaining code quality becomes progressively harder as the project grows. It supports developers who need a streamlined process for improving their code while ensuring full compliance with predefined standards and instructions.

FAQ

How do I use the review-and-refactor skill?

To use this skill, review the coding guidelines and instructions in the relevant `.md` files and then apply the necessary refactoring to the project code. Make sure to maintain the structure of the existing files and confirm that all tests pass after the refactor.

What happens if the project includes tests?

If the project includes tests, the skill ensures they still pass after the code refactoring. The refactor process should not interfere with existing functionality, including tests.

Can I modify the project structure when using this skill?

No, the skill requires that the existing project structure and files remain intact. The focus is only on code refactoring and ensuring adherence to coding standards.

Are there any specific coding guidelines required for using this skill?

Yes, the skill relies on coding instructions defined in `.github/instructions/*.md` and `.github/copilot-instructions.md`. You should review these guidelines before initiating the refactor process.

What are the limitations of the review-and-refactor skill?

The skill does not create new tests or add new functionality. It only focuses on code refactoring while ensuring compliance with existing coding standards and guidelines. It also does not alter the overall project structure or file organization.

Install review-and-refactor

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill