Import contribution-check workflow from github/gh-aw

[github-actions]

Summary

This PR imports the contribution-check workflow from the github/gh-aw repository and adapts it for general use in the agentics collection.

Source

https://github.com/github/gh-aw/blob/main/.github/workflows/contribution-check.md

What it does

The contribution-check workflow provides scheduled batch review of open pull requests against a repository's contribution guidelines. It:

• Runs every 4 hours (configurable schedule)
• Fetches and filters open PRs using smart pre-filtering (skips maintainers, trusted contributors, small PRs, already-triaged PRs)
• Delegates each PR evaluation to a dedicated subagent (.github/agents/contribution-checker.agent.md)
• Compiles results into a structured report issue with PRs grouped by status:
  • 🟢 Ready to review (lgtm)
  • 🟡 Needs a closer look (needs-work)
  • 🔴 Off-guidelines (spam)
• Posts constructive feedback comments to PRs that need work
• Includes agentic prompts in comments that contributors can use with their AI coding agents

Adaptations made

The original workflow was specific to the openclaw/openclaw project. The following changes were made to generalize it:

1. Removed hardcoded repository references: The original used TARGET_REPOSITORY env var with a default of openclaw/openclaw. Generalized to use github.repository for the current repository.

2. Removed target-repo parameters: The original had target-repo parameters in safe-outputs pointing to an external repository. The generalized version evaluates PRs in the repository where it's installed.

3. Added source attribution: Added source: field in frontmatter pointing to the original workflow URL.

4. Created subagent file: Copied the .github/agents/contribution-checker.agent.md subagent that the orchestrator depends on.

5. Updated permissions: Changed to pull-requests: write since the workflow posts comments and labels to PRs.

6. Created documentation: Added comprehensive docs page following the established pattern in this repository.

Category

Added to Code Review Workflows section in README.md, as this workflow helps review and triage community contributions.

Files changed

• workflows/contribution-check.md - Main orchestrator workflow
• .github/agents/contribution-checker.agent.md - Subagent that evaluates individual PRs
• docs/contribution-check.md - Documentation page
• README.md - Added entry in Code Review Workflows section

Notes

• Compilation pending: The workflow has not been compiled yet (no .lock.yml file) as the awf compile command requires Docker which isn't available in this environment. The workflow should be compiled with gh aw compile workflows/contribution-check.md after merging.

• Dependencies: This workflow depends on the repository having a CONTRIBUTING.md file (or .github/CONTRIBUTING.md or docs/CONTRIBUTING.md). If no contribution guidelines exist, PRs will be marked with no-guidelines quality.

• Customization needed: Before use, repositories should review the filter logic in the github-script step and adjust the SKIP_LABELS and SMALL_LABELS sets to match their labeling conventions.

Testing

The workflow structure follows the same pattern as existing workflows in this repository. It has been verified for:

• ✅ Valid frontmatter structure
• ✅ Proper safe-outputs configuration
• ✅ Subagent file in correct location
• ✅ Documentation matches existing pattern
• ✅ README integration

The workflow will need actual runtime testing after compilation to ensure the orchestrator → subagent flow works correctly.

AI generated by Import Workflow from Prompt Repository