# PR Review

Review of a PR, branch, or your own uncommitted work across eight dimensions, ...

- Repository: https://github.com/apache/tika (4119 stars)
- Category: Testing
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add apache/tika --skill pr-review -g -a claude-code -y`
Codex: `npx skills add apache/tika --skill pr-review -g -a codex -y`
Cursor: `npx skills add apache/tika --skill pr-review -g -a cursor -y`
Gemini CLI: `npx skills add apache/tika --skill pr-review -g -a gemini-cli -y`

## Description

Review of a PR, branch, or your own uncommitted work across eight dimensions, security, correctness, test coverage, API/compatibility, usability, documentation, code quality, performance. Sizes the diff, reviews inline or fans out reviewers off a shared brief, verifies findings against code, reports a grouped list with a shape verdict, fixes on approval. Use for "review this PR", "/pr-review 3011", or a pre-flight self-review before submitting; add "thorough" for adversarial verification.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements.  See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License.  You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->

Local override: `$TIKA_SKILLS_LOCAL/pr-review/LOCAL.md` (default `~/.tika-skills`),
read after this file, wins on conflict.

# PR Review

## Pre-flight: self-review before submitting

No PR number, no `gh`; scope is `main...HEAD` plus uncommitted. Inline, no
fan-out: walk dimensions 2 and 3 over every touched file, then §4 hygiene in
full (it is mechanical and it is what costs a review round-trip). Fix what
you find, then submit, no report to paste. Opt into the full path only for
a large or API-changing change.

## 1. Resolve scope

- PR number → `gh pr view <N> --json headRefName,baseRefName` (read-only);
  diff is `git diff <base>...<head>`.
- Branch → diff against `main`. No argument → `main...HEAD` + uncommitted.

Resolve the merge-base to a SHA once (`git merge-base <base> <head>`); a
symbolic base drifts if anything fetches mid-review. Record it in the report.

The rest: https://github.com/apache/tika/blob/HEAD/.skills/devs/pr-review/SKILL.md
