Review And Refactor — Agent Skill by GitHub

From the author

Review and refactor code in your project according to defined instructions

— the description by sinedied

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

This skill acts as a senior software engineer tasked with auditing and improving existing codebases. It systematically reviews project-specific coding guidelines and instructions to ensure that the code remains clean and maintainable. The agent focuses on applying established standards to existing files without splitting them, while verifying that any associated tests remain functional after modifications.

What it does

Analyzes project code against specified coding guidelines and instructions.
Performs refactoring to improve code cleanliness and maintainability.
Maintains existing file structures without splitting code.
Verifies that existing tests continue to pass after refactoring.

When to use it

When you need to align an existing codebase with updated internal coding standards.
When you want to perform a cleanup of legacy code while ensuring test stability.
When you require a senior-level review of code to ensure it follows project-specific best practices.

Advantages

Ensures consistency by strictly adhering to project-defined instructions.
Preserves existing file architecture during the refactoring process.
Reduces the risk of regressions by checking test status.

Usage examples

“Review and refactor the current project code based on the instructions in the .github folder.”: The agent will read the specified instruction files, analyze the codebase, and apply refactoring changes to improve code quality while keeping tests passing.

Install

Download the skill as a ZIP:
https://autogineer.com/agent-skills/github/review-and-refactor/download

Unzip it into the cross-client skills folder of your project:

mkdir -p .agents/skills && unzip review-and-refactor.zip -d .agents/skills

Documentation by sinedied

Role

You're a senior expert software engineer with extensive experience in maintaining projects over a long time and ensuring clean code and best practices.

Task

Take a deep breath, and review all coding guidelines instructions in .github/instructions/*.md and .github/copilot-instructions.md, then review all the code carefully and make code refactorings if needed.
The final code should be clean and maintainable while following the specified coding standards and instructions.
Do not split up the code, keep the existing files intact.
If the project includes tests, ensure they are still passing after your changes.

Files

ATTRIBUTION.mdAdded by AutoGineer1.1 KiB
LICENSELicence file added by AutoGineer1.0 KiB
SKILL.md770 B

Requirements and compatibility

Written for: GitHub Copilot

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Names Copilot tools

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Pr
Matt Pocock· Community
A standardized template and set of best practices for writing clear, evidence-based pull request descriptions.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository317.5k
Retro
Matt Pocock· Community
Conduct a structured retrospective on coding sessions to improve agent environment and performance.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository317.5k
Triage
Matt Pocock· Community
A systematic workflow for managing, verifying, and preparing project issues and pull requests for agent-led implementation.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository317.5k
Code Review
Matt Pocock· Community
Performs a dual-axis code review by comparing changes against project standards and functional specifications in parallel.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository317.5k
Requesting Code Review
Jesse Vincent (obra)· Community
A structured workflow for dispatching an AI subagent to perform automated code reviews on specific git commits.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository314k
Code Simplification
Addy Osmani· Community
A systematic, model-agnostic process for refactoring code to improve readability and maintainability without altering existing behavior.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository113.9k