Github-workflow to automate validation of new PRs based on Contribution Guidelines of the repository (#162)

Github-Workflow to automate validation of pull requests against your
repository's "CONTRIBUTING.md" guidelines using Google Gemini.

Key Features:
- Smart validation - understands complex guidelines beyond simple
pattern matching
- Actionable feedback - provides specific checklist items with links to
guidelines
- Manual re-validation via "/validate-contribution" comments in PRs
- Configurable enforcement - can warn or fail based on violations

Perfect for maintaining contribution quality while being helpful to new
contributors.

Author: jasmeetsb

examples/workflows/AWESOME.md

@@ -31,7 +31,38 @@ Workflows that help maintain code quality, perform analysis, or enforce standard
 
 Workflows that help manage GitHub issues, projects, or team collaboration.
 
-*No workflows yet. Be the first to contribute!*
+### 1. Workflow to Enforce Contribution Guidelines in Pull Requests
+
+**Repository:** [jasmeetsb/gemini-github-actions](https://github.com/jasmeetsb/gemini-github-actions)
+
+**Description:** Automates validation of pull requests against your repository's CONTRIBUTING.md using the Google Gemini CLI. The workflow posts a single upserted PR comment indicating PASS/FAIL with a concise checklist of actionable items, and can optionally fail the job to enforce compliance.
+
+**Key Features:**
+
+- Reads and evaluates PR title, body, and diff against CONTRIBUTING.md
+- Posts a single PR comment with a visible PASS/FAIL marker in Comment Title and details of compliance status in the comment body
+- Optional enforcement: fail the workflow when violations are detected
+
+**Setup Requirements:**
+
+- Copy [.github/workflows/pr-contribution-guidelines-enforcement.yml](https://github.com/jasmeetsb/gemini-github-actions/blob/main/.github/workflows/pr-contribution-guidelines-enforcement.yml) to your .github/workflows/ folder.
+- File: `CONTRIBUTING.md` at the repository root
+- (Optional) Repository variable `FAIL_ON_GUIDELINE_VIOLATIONS=true` to fail the workflow on violations
+
+**Example Usage:**
+
+- Define contribution guidelines in CONTRIBUTING.md file
+- Open a new PR or update an existing PR, which would then trigger the workflow
+- Workflow will validate the PR against the contribution guidelines and add a comment in the PR with PASS/FAIL status and details of guideline compliance and non-compliance
+
+  **OR**
+
+- Add following comment in an existing PR **"/validate-contribution"** to trigger the workflow
+
+**Workflow File:**
+
+- Example location in this repo: [.github/workflows/pr-contribution-guidelines-enforcement.yml](https://github.com/jasmeetsb/gemini-github-actions/blob/main/.github/workflows/pr-contribution-guidelines-enforcement.yml)
+- Typical usage in a consumer repo: `.github/workflows/pr-contribution-guidelines-enforcement.yml` (copy the file and adjust settings/secrets as needed)
 
 ### 📝 Documentation