Skip to main content

generate-code-review-rules

Inspect a repository and create or update an evidence-based `## Code Review Rules` section in the applicable `AGENTS.md`. Use when asked to tailor the PR Review Toolkit, document repository-specific review gates, generate review rules, or improve AGENTS.md guidance for code review. This skill edits AGENTS.md but does not review or modify implementation 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
3 files

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
generate-code-review-rules
description
Inspect a repository and create or update an evidence-based `## Code Review Rules` section in the applicable `AGENTS.md`. Use when asked to tailor the PR Review Toolkit, document repository-specific review gates, generate review rules, or improve AGENTS.md guidance for code review. This skill edits AGENTS.md but does not review or modify implementation code.
# Generate Code Review Rules Create concise rules that help reviewers distinguish real defects from noise. Read [rules-template.md](references/rules-template.md) before editing. ## Workflow 1. Locate the repository root and all existing `AGENTS.md` files. Read the applicable instruction hierarchy before editing. 2. Inspect evidence without changing state: - build, test, lint, type-check, and formatting configuration; - CI workflows and required checks; - package/module manifests and supported runtimes/platforms; - public API, schema, migration, compatibility, generated-code, and test conventions; - recurring review guidance already documented in the repository. 3. Convert only stable, repository-specific evidence into review rules. Every rule must name what a reviewer should verify and when it applies. Do not invent conventions from one incidental example. 4. Choose scope deliberately: - Put repository-wide rules in the root `AGENTS.md`. - Put specialized rules in a nested `AGENTS.md` only when they apply exclusively to that subtree. - Do not duplicate a parent rule in children. 5. Create or replace exactly one `## Code Review Rules` section in each selected file while preserving all unrelated content and formatting. If `AGENTS.md` does not exist, create the minimum file needed. 6. Review the resulting diff. Remove generic advice, style preferences already enforced mechanically, unverified commands, and rules that cannot produce a clear pass/fail review decision. 7. Report which files changed and cite the repository evidence behind each added rule. Do not run the PR review automatically. Keep the section compact. Prefer 3–10 strong bullets over an exhaustive checklist. Do not hard-code branch names, file layouts, tools, languages, or hosting providers unless the repository evidence establishes them.
View on GitHub