← Explore all 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.

“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.

Upstream setup instructions ↗
  1. Copy the agent file at the reviewed commit into the location your host uses for custom agents.
  2. 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.

  1. Agent definition ↗Checked

    https://github.com/github/gh-aw/blob/4b8a35e4047e6eaa1c7e08181e3e00204af99896/.github/agents/contribution-checker.agent.md

    Supports: summary, whySelected, limitations

  2. MIT licence ↗Checked

    https://github.com/github/gh-aw/blob/4b8a35e4047e6eaa1c7e08181e3e00204af99896/LICENSE

    Supports: Redistribution terms

Evidence & Ask