Skip to main content

simplify-reviewed-code

Optionally edit recently reviewed code to reduce unnecessary complexity while preserving behavior and repository conventions. Use only when the user explicitly asks to simplify, clarify, refactor, or polish reviewed changes. Do not trigger as part of PR review, finding validation, or Code Review Rules generation because this skill modifies code.

Source facts

Repository
neonwatty/codex-pr-review-toolkit
Last source activity
August 4, 2026 at 20:04
Detected SKILL.md language
English
Stars
2
Forks
0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer
2 files

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
simplify-reviewed-code
description
Optionally edit recently reviewed code to reduce unnecessary complexity while preserving behavior and repository conventions. Use only when the user explicitly asks to simplify, clarify, refactor, or polish reviewed changes. Do not trigger as part of PR review, finding validation, or Code Review Rules generation because this skill modifies code.
# Simplify Reviewed Code Keep this workflow separate from review. Announce that it will modify code before editing. ## Workflow 1. Confirm the exact files or diff to simplify and inspect the worktree. Preserve unrelated user changes. 2. Read applicable `AGENTS.md` instructions and identify the repository's verification commands from evidence. 3. Establish a behavioral baseline with focused tests when practical. If the baseline already fails, record that before editing. 4. Simplify only changed or explicitly named code. Favor direct control flow, meaningful names, fewer redundant branches, and removal of abstractions that add no semantic value. 5. Preserve public behavior, error semantics, ordering, concurrency, performance requirements, API/wire shapes, comments that explain non-obvious constraints, and compatibility guarantees. 6. Do not silently fix review findings, broaden scope, alter tests to bless changed behavior, or change repository rules. Ask for separate authorization when simplification reveals a behavioral defect. 7. Re-run the focused baseline plus relevant repository checks. Inspect the final diff for accidental behavior changes. 8. Report edits and verification. If no safe simplification is worthwhile, make no changes and say so. Prefer no edit over a clever or speculative refactor. Never commit, push, or post review comments unless the user separately requests it.
View on GitHub