diff --git a/README.md b/README.md
index c6345487..8b396788 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,174 @@
 # Shell
-Schell Scripts
+
+A lightweight collection of useful shell scripts and command-line utilities designed to automate everyday tasks, streamline workflows, and boost productivity.
+
+---
+
+## 🚀 Features
+
+* Simple and easy-to-use shell scripts.
+* Automation for repetitive tasks.
+* Beginner-friendly structure.
+* Lightweight and fast.
+* Easy to customize and extend.
+
+---
+
+## 📂 Project Structure 
+
+```bash
+Shell/
+├── scripts/
+│   ├── script1.sh
+│   ├── script2.sh
+│   └── ...
+├── README.md
+└── LICENSE
+```
+
+---
+
+## ⚙️ Prerequisites
+
+Before running the scripts, make sure you have:
+
+* Linux / macOS / WSL
+* Bash or compatible shell
+* Basic terminal knowledge
+
+Check your bash version:
+
+```bash
+bash --version
+```
+
+---
+
+## 🛠️ Installation
+
+Clone the repository:
+
+```bash
+git clone https://github.com/AnirbanB13/Shell.git
+cd Shell
+```
+
+Give execution permission to scripts:
+
+```bash
+chmod +x *.sh
+```
+
+Or for all scripts inside folders:
+
+```bash
+find . -name "*.sh" -exec chmod +x {} \;
+```
+
+---
+
+## ▶️ Usage
+
+Run any script using:
+
+```bash
+./script-name.sh
+```
+
+Or:
+
+```bash
+bash script-name.sh
+```
+
+Example:
+
+```bash
+./backup.sh
+```
+
+---
+
+## 📌 Example Use Cases
+
+* File backup automation.
+* Log cleanup.
+* Docker/container helpers.
+* DevOps utilities.
+* Git automation.
+* System monitoring.
+* AWS/Linux administration tasks.
+
+---
+
+## 🧠 Learning Goals
+
+This repository is also intended as a hands-on learning space for:
+
+* Shell scripting
+* Linux command-line tools
+* Automation concepts
+* DevOps fundamentals
+* Scripting best practices
+
+---
+
+## 🔒 Permissions Note
+
+If you encounter permission issues:
+
+```bash
+chmod +x filename.sh
+```
+
+---
+
+## 🤝 Contributing
+
+Contributions, suggestions, and improvements are welcome.
+
+1. Fork the repository
+2. Create a new branch
+3. Commit your changes
+4. Push to your branch
+5. Open a Pull Request
+
+---
+
+## 🐞 Troubleshooting
+
+### Script not running?
+
+Make sure:
+
+* The script has executable permissions
+* Bash is installed
+* You are running from the correct directory
+
+### Command not found?
+
+Install the required package or dependency mentioned in the script.
+
+---
+
+## 📖 Future Improvements
+
+* Add more automation scripts
+* Improve error handling
+* Add logging support
+* Add interactive menu system
+* Add configuration support
+
+---
+
+## 📜 License
+
+This project is licensed under the MIT License.
+
+---
+
+## 👨‍💻 Author
+
+Created by Anirban Banerjee.
+
+GitHub: [AnirbanB13 GitHub Profile](https://github.com/AnirbanB13?utm_source=chatgpt.com)
diff --git a/addition.sh b/addition.sh
new file mode 100644
index 00000000..51c15085
--- /dev/null
+++ b/addition.sh
@@ -0,0 +1,5 @@
+read -p "enter first number: " num1
+read -p "enter second number: " num2
+
+sum=$((num1 + num2))
+echo "The sum of $num1 and $num2 is: $sum"
\ No newline at end of file
diff --git a/author.sh b/author.sh
new file mode 100644
index 00000000..f00b7748
--- /dev/null
+++ b/author.sh
@@ -0,0 +1,3 @@
+#!/bin/bash
+
+# just a placeholder file to run all the arithmetic operations in one go. This file is not meant to be executed directly, but rather to be sourced by test.sh which will call each of the individual operation scripts.
\ No newline at end of file
diff --git a/multiplication.sh b/multiplication.sh
new file mode 100644
index 00000000..19937924
--- /dev/null
+++ b/multiplication.sh
@@ -0,0 +1,6 @@
+read -p "enter first number: " num1
+read -p "enter second number: " num2        
+
+product=$((num1 * num2))
+
+echo "The product of $num1 and $num2 is: $product"
\ No newline at end of file
diff --git a/test.sh b/test.sh
new file mode 100644
index 00000000..de5ec9e9
--- /dev/null
+++ b/test.sh
@@ -0,0 +1,7 @@
+#!/bin/bash
+
+# Test script to run all arithmetic operations
+bash addition.sh
+bash multiplication.sh
+bash substraction.sh
+bash division.sh
\ No newline at end of file