Review a skillshare change before it becomes a pull request, or review an open pull request. Use this skill whenever the user asks to: review a diff, branch, commit range or PR, check a change before opening a PR, run a pre-Codex review, or find what a change missed. It checks correctness, the repository's documented rules, the originating issue or spec, every consumer of a changed concept, and cleanup (reuse, simplification, efficiency, depth of fix), then verifies each finding against the code before reporting it. Read-only unless the user asks for fixes.
96%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Low
Low-risk findings worth noting
Review one change in five independent passes, verify every finding, and report them by pass. $ARGUMENTS names the target (a base ref, a PR number, or a path) and may end with fix.
Scope: Read-only by default. With fix, apply only verified findings that do not change intended behavior, then run the checks the testing topic names. Never commit, push, or comment on GitHub unless the user asks.
Before acting, run python3 scripts/ai-context.py pull-requests. Its Review Rounds section defines what a review must sweep before Codex sees the change; this skill is how that sweep runs.
| $ARGUMENTS | Diff |
|---|---|
| empty | git diff origin/main...HEAD plus git diff HEAD (uncommitted work counts) |
| a ref | git diff <ref>...HEAD plus git diff HEAD |
| a PR number | check the PR out in a new scratch worktree (git worktree add, then gh pr checkout <n> inside it) and review there with git diff origin/<base>...HEAD, so Step 4 reads the PR's code, not the current branch |
| a path | that file or directory, reviewed whole |
Run git fetch origin first so the base is current. Stop here if the ref does not resolve or the diff is empty. In a shared checkout, list files changed by another session (git status) and leave them out of scope.
gh issue view <n>), a path in $ARGUMENTS, or a matching file in specs/. If none exists, the Spec pass reports "no spec".AGENTS.md, plus the topics for the touched areas. Run python3 scripts/ai-context.py list and pick by path: cmd/ and internal/ → cli-development; ui/ or website/src/ → frontend; docs, READMEs, skills/ → documentation; wiki/ → ai-context.Launch one subagent per pass in a single message, using your tool's default subagent model; do not name a model the tool may not have. If your tool has no subagents, run the passes yourself one after another. Give each the diff command, the context from Step 2, and its brief below. Each returns findings as file:line, a one-sentence claim, and a concrete scenario (input or state → wrong result). A finding without a scenario is not reported.
AGENTS.md and the loaded topics. Cite the file and rule.skills/skillshare/references and ui/src/i18n/locales. Report each consumer the diff did not update, and each state dimension the change crosses without a test. Translations count as consumers: for every changed file under website/docs/, check the same path under each website/i18n/<locale>/docusaurus-plugin-content-docs/current/, and for README.md, each translated README. Report each copy that exists but was not updated to match, with the English lines it is missing.For every finding, read the cited code yourself and decide:
Use the user's language. Keep the passes separate and do not rerank across them: a change can pass the spec and still break a rule.
## Correctness (n)
1. CONFIRMED path:line: claim. Scenario: ...
## Rules (n)
## Spec (n) or: no spec
## Consumers (n)
## Cleanup (n)
Dropped: n. Not checked: <passes or areas skipped, and why>.End with the single most severe confirmed finding per pass, or "clean".
With fix: apply the CONFIRMED findings, add a failing test first for each correctness fix, rerun the narrowest check that proves it, and report each finding as fixed, skipped (why), or no change needed.
go test, make test, skillshare, or frontend scripts on the host. Checks run in the devcontainer, as the testing topic describes.runkids/skillshare
7ca59a0
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.