---
title: "Contribution checker: review, role & definition · Undominated.ai"
canonical: https://undominated.ai/agents/github-contribution-checker/
description: "Reads one pull request against that repository's contributing guide and returns one JSON verdict from checklist answers."
---

# Contribution checker: review, role & definition · Undominated.ai

> Reads one pull request against that repository's contributing guide and returns one JSON verdict from checklist answers.

[← Explore all agents](/agents/)

PULL-REQUEST REVIEW / GitHub

# Contribution checker

Reads one pull request against that repository's contributing guide and returns one JSON verdict from checklist answers.

 [Use this definition ↓](#setup)[Original source ↗](https://github.com/github/gh-aw/blob/4b8a35e4047e6eaa1c7e08181e3e00204af99896/.github/agents/contribution-checker.agent.md)

SOURCE REVIEW

 Reviewed 2026-10-14
 Evidence 2 linked sources
 Publisher GitHub
 Licence [MIT ↗](https://github.com/github/gh-aw/blob/4b8a35e4047e6eaa1c7e08181e3e00204af99896/LICENSE)
 Revision 4b8a35e4047e
 [Read what was—and wasn’t—checked ↓](#review)

“Evaluate a single PR against the target repository's CONTRIBUTING.md for compliance and quality”

 [GitHub · upstream description ↗](https://github.com/github/gh-aw/blob/4b8a35e4047e6eaa1c7e08181e3e00204af99896/.github/agents/contribution-checker.agent.md) Our analysis follows below.

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.

### A good fit for

 - Provide owner/repo#number and trusted contributing guidelines, or permit read-only retrieval of the first available guideline file.
- Receive one JSON verdict with checklist signals, changed-line count and draft comment text.

### Weigh up before choosing

 - user-invokable is false: an orchestrator must call the role.
- Despite describing a comment field as posted text, its final rule explicitly forbids comments, labels or repository writes; return the text only.
- This is triage, not correctness review: it forbids surrounding-code inspection, and its bot-author shortcut is not safety evidence.

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.

[Upstream setup instructions ↗](https://github.com/github/gh-aw/blob/4b8a35e4047e6eaa1c7e08181e3e00204af99896/.github/agents/contribution-checker.agent.md)
 - 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

### Compatibility

Hosts that can load a Markdown agent file

### Implementation

Markdown

### Read-only by the file's closing rule; the comment field is still written as something posted

 - The body says to use only the pull request metadata, diff, and contributing guidelines.
- The body forbids writing comments or labels to the target repository.

### Cost model

MIT. The file does not state a hosted-model price.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Agent definition ↗](https://github.com/github/gh-aw/blob/4b8a35e4047e6eaa1c7e08181e3e00204af99896/.github/agents/contribution-checker.agent.md) Checked 2026-10-14 https://github.com/github/gh-aw/blob/4b8a35e4047e6eaa1c7e08181e3e00204af99896/.github/agents/contribution-checker.agent.md Supports: summary, whySelected, limitations
- [MIT licence ↗](https://github.com/github/gh-aw/blob/4b8a35e4047e6eaa1c7e08181e3e00204af99896/LICENSE) Checked 2026-10-14 https://github.com/github/gh-aw/blob/4b8a35e4047e6eaa1c7e08181e3e00204af99896/LICENSE Supports: Redistribution terms

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Codex Rust review ↗ A Codex label prompt for one codex-rs pull request: a short change summary, then a friendly review that pushes mixed changes apart and flags unsafe and crate placement.](/agents/openai-codex-rust-review/)[### Adversarial modeler ↗ Pins Trail of Bits' differential-review agent that models high-risk changes and says not to run on low or medium risk diffs.](/agents/trailofbits-adversarial-modeler/)[### AWS provider maintainer review ↗ A short review persona for AWS provider changes. It says not to open pull requests.](/agents/hashicorp-aws-provider-maintainer/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Find reusable instructions](/skills/)
- [Inspect connections](/mcp-servers/)
- [Build a toolkit](/tools/)
- [Choose the model](/compare/)
