GitHub - mogwi1983/policybot: PolicyBot - Commit Convention Enforcer. One GitHub Action that enforces Conventional Commits, PR title format, and PR description quality. · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
mogwi1983
policybot
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
Use this GitHub action with your project<br>Add this Action to an existing workflow or create a new one<br>View on Marketplace
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>4 Commits<br>4 Commits
.github/workflows
.github/workflows
dist
dist
src
src
test
test
.gitignore
.gitignore
LICENSE
LICENSE
README.md
README.md
action.yml
action.yml
package-lock.json
package-lock.json
package.json
package.json
View all files
Repository files navigation
🛡️ PolicyBot — Commit Convention Enforcer
One GitHub Action that enforces Conventional Commits , PR title format , and PR description quality . Zero config to start — add one line to your workflow.
Features
✅ Conventional Commits — Validates every commit message follows type(scope): description
✅ PR Title checking — Same grammar applied to the PR title
✅ PR Description quality — Configurable minimum description length
✅ Fork PR support — Works for PRs from forks (no secrets needed)
✅ Customizable types — Configure which commit types are allowed
✅ Repo-level config — Optional .github/policybot.yml for per-repo rules
Quick Start
Add to your .github/workflows/policybot.yml:
name: PolicyBot<br>on:<br>pull_request:<br>types: [opened, synchronize, reopened]
jobs:<br>check:<br>runs-on: ubuntu-latest<br>steps:<br>- uses: mogwi1983/policybot@v1<br>with:<br>github-token: ${{ github.token }}
That's it. Every PR will now be checked.
Configuration
Action Inputs
Input<br>Default<br>Description
github-token<br>${{ github.token }}<br>Token for reading PR data
check-commits<br>true<br>Validate commit messages
check-pr-title<br>true<br>Validate PR title
min-description-length<br>Min PR body chars (0 = off)
allowed-types<br>feat,fix,docs,...<br>Allowed commit types
Repo-Level Config (.github/policybot.yml)
check_commits: true<br>check_pr_title: true<br>min_description_length: 50<br>allowed_types: feat,fix,docs,style,refactor,test,chore
Allowed Commit Types
feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
License
MIT — see LICENSE.
About
PolicyBot - Commit Convention Enforcer. One GitHub Action that enforces Conventional Commits, PR title format, and PR description quality.
Resources
Readme
License
MIT license
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
star
Watchers
watching
Forks
forks
Report repository
Releases
V1- initial release
Latest
Jul 7, 2026
+ 1 release
Packages
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
JavaScript<br>100.0%
You can’t perform that action at this time.