📝 add how to validate locally (#135)

.gitignore

@@ -132,3 +132,6 @@ dmypy.json
 
 # macOS files that should be excluded from git
 .DS_Store
+
+validation_report.md
+

README.md

@@ -18,3 +18,32 @@ To be clear about the implications of using scripts in packages. We need to doub
 - even if the package does not contain scripts, it needs a human reviewer nonetheless: it might have content that we don't want to be part of distributing, such as offensive/hateful language or images
 
 The process of creating this review policy can be tracked in [#98](https://github.com/espanso/hub/issues/98)
+
+## Run the package validation locally
+
+Sometimes it's useful to run the validation process locally. To do so, you have
+to make the following steps:
+
+- have python 3.12 installed and make an environment in your local folder. We
+use [`uv`](https://github.com/astral-sh/uv) often, and if you don't know it yet
+, you should!
+
+```bash
+uv venv --python 3.12
+```
+
+- install the `pyyaml` dependency
+
+```bash
+uv pip install pyyaml
+```
+
+- run the `main.py` *from the root folder* (because the script uses `glob` to
+find what packages are in the `packages/` folder)
+
+```bash
+uv run .github/scripts/validate/main.py
+```
+
+- wait until you have the results!
+