diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6fba59d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+# Various useful scripts
+
+A collection of scripts I've made during the years to fulfill specific needs (my own). Some they may be useful for others, some may be not.
+
+They're all written either in Bash or in Python (3.x).
+
+## Structure
+
+- `obs`: Scripts used to manage the KDE Unstable repositories on the openSUSE Build Service
+- `sysadmin`: Various scripts I wrote to carry out some sysadmin-y stuff
+- `travel`: Experimental scripts I wrote to make planning my holidays better
+- `misc`: Uncategorized, random scripts.
+
+## LICENSE
+
+Different scripts have different licenses. See the `LICENSES` directory for a rundown of the used licenses.
diff --git a/obs/README.md b/obs/README.md
new file mode 100644
index 0000000..15ddd23
--- /dev/null
+++ b/obs/README.md
@@ -0,0 +1,10 @@
+# Open Build Service related scripts
+
+These scripts are used to update the KDE unstable packages on the openSUSE Build Service, namely the [core Plasma and Frameworks packages](https://build.opensuse.org/project/show/KDE:Unstable:Frameworks), the [applications part of the Release Service](https://build.opensuse.org/project/show/KDE:Unstable:Applications), and [other KDE applications](https://build.opensuse.org/project/show/KDE:Unstable:Extra).
+
+- `update_unstable.py` is the Python script which checks the repositories (configuration in `config/repo_config.json`) and compares the latest known git revision hash with the one stored (`data/obs_repo_cache.json`) and then signals the OBS to update the checkout and build them.
+- `fix_broken.sh` is a bash script which checks the state of the OBS in case there were issues with the git checkout and prods the service to do it again.
+
+## License
+
+All scripts are licensed with a BSD 3 clause license.