feat: add a pre-commit hook (#8)

* feat: add a pre-commit hook

Signed-off-by: Ali Sajid Imami <395482+AliSajid@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Andrey Sitnik <andrey@sitnik.ru>

* docs: add consistent spacing and link

Signed-off-by: Ali Sajid Imami <395482+AliSajid@users.noreply.github.com>

---------

Signed-off-by: Ali Sajid Imami <395482+AliSajid@users.noreply.github.com>
Co-authored-by: Andrey Sitnik <andrey@sitnik.ru>

Author: AliSajid

README.md

@@ -25,6 +25,15 @@ Rules:
        alt="Sponsored by Evil Martians" width="236" height="54">
 </a>
 
+## Pre-Commit Hook
+
+This project is also available as a [pre-commit hook](https://pre-commit.com/). Please add the following to your pre-commit configuration.
+
+```yaml
+repos:
+  - repo: https://github.com/browserslist/lint
+    id: browserslist-lint
+```
 
 ## JS API
 

pre-commit-hooks.yaml

@@ -0,0 +1,16 @@
+# Define the hooks available in this repository
+- id: browserslist-lint
+  name: Validate Browserslist Configuration
+  # Command to execute the linter using npx for local installation
+  entry: npx browserslist-lint
+  # Specify the language for the hook; 'node' is used for npm-based tools
+  language: node
+  # Regular expression to match files that should trigger the hook
+  # The hook will run if `.browserslistrc` or `package.json` is modified
+  files: (\.browserslistrc|package\.json)$
+  # Disable passing filenames as arguments since the linter inspects its own targets
+  pass_filenames: false
+  # Run the hook only when relevant files are modified, not always
+  always_run: false
+  # Description of the hook to inform users about its purpose
+  description: Validate Browserslist configuration using browserslist-lint.