PULL-REQUEST REVIEW / GitHub
Contribution checker
Reads one pull request against that repository's contributing guide and returns one JSON verdict from checklist answers.
“Evaluate a single PR against the target repository's CONTRIBUTING.md for compliance and quality”
01 / THE REASONING
Why this made the selection.
- The agent must answer from the pull request metadata, diff, and CONTRIBUTING.md, and must not browse the rest of the repo.
- A later rule says never to write comments or labels, while the comment field is described as text posted to the pull request.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- .github/agents/contribution-checker.agent.md
- LICENSE
- Definition reread at the preserved revision; scoped workflow and output-contract review on 2026-10-14
Our findings
- Frontmatter sets user-invokable to false and does not declare a tools list.
- If the author is github-actions[bot], the file says to return the 🟢 verdict, quality lgtm, and an empty comment without the checklist.
- The output is one JSON object whose fields include number, verdict, on_topic, focused, deps, tests, lines, quality, existing_labels, title, author, and comment.
- The read-only rule says never to write to the target repo, including no comments and no labels.
- The source has a material bypass: PRs authored by github-actions[bot] receive lgtm without the checklist. Remove that shortcut in a working copy before relying on its verdict.
- It limits evidence to metadata/diff/guidelines and linked issue context; missing guidelines return no-guidelines instead of an approval.
Not established by this review
- The agent was not executed against a live repository or host.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Use the role in your project.
- Copy the agent file at the reviewed commit into the location your host uses for custom agents.
- No install command is published. Do not let the host post the comment field unless you have decided to override the file's read-only rule.
Before you start
- A pull request reference in owner/repo#number form
- Access to that repository's contributing guide and diff
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- Agent definition ↗Checked
https://github.com/github/gh-aw/blob/4b8a35e4047e6eaa1c7e08181e3e00204af99896/.github/agents/contribution-checker.agent.md
Supports: summary, whySelected, limitations
- MIT licence ↗Checked
https://github.com/github/gh-aw/blob/4b8a35e4047e6eaa1c7e08181e3e00204af99896/LICENSE
Supports: Redistribution terms