diff --git a/README.md b/README.md
index ac6e405..563f903 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,16 @@
 # random-bash-scripts
 
-Just a random bash scripts for daily uses
\ No newline at end of file
+Just a random bash scripts for daily uses
+
+| name | small description |
+| --- | --- |
+| k8s-talos-safe-shutdown.sh | This script will grace shutdown talos k8s cluster in proxmox! designed to run from the Proxmox host via SSH to management host.
+- Verify connectivity — checks all nodes are Ready before doing anything
+- Suspend Flux — stops it from fighting the shutdown with reconcile loops
+- Cordon workers — prevents any new pods scheduling during drain
+- Drain workloads — gracefully evicts pods with a 30s grace period
+- Wait for Longhorn detach — polls until all volumes are detached (or times out safely)
+- Talos shutdown — workers first, then waits 30s, then control plane
+- Send graceful shutdown to all running VMs/CTs
+- Poweroff Proxmox — only after everything else is clean
+|
\ No newline at end of file