diff --git a/README.md b/README.md
index e69de29..2adb6e1 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,10 @@
+# Ansible Playbooks for Semaphore UI
+
+A curated set of Ansible playbooks designed to work seamlessly with the Semaphore CI/CD interface. The collection covers common automation tasks such as system checks, configuration, installation, and routine maintenance across various Linux distributions.
+
+## Repository Overview
+
+- **Checks & Health** – Ping tests, service status verification, and overall health monitoring.
+- **Configuration** – Centralized host configuration, master node creation, and system tweaks.
+- **Installation** – Automated OS installations (Arch, RHEL) and package updates (DNF).
+- **Maintenance** – Regular updates, cleanup, and other upkeep tasks.