diff --git a/auto_tag_plugin/README.md b/auto_tag_plugin/README.md
new file mode 100644
index 0000000..1189fd5
--- /dev/null
+++ b/auto_tag_plugin/README.md
@@ -0,0 +1,45 @@
+# Auto Tag Plugin
+
+## Overview
+
+The **Auto Tag Plugin** automatically tags links based on their content using pre-configured keyword-to-tag mappings. It ensures consistent and relevant tagging while saving time.
+
+## Features
+
+- Automatically adds tags to links based on title, URL, description, and content.
+- Fully customizable keyword-to-tag mappings.
+- Adds a fixed tag (`auto-tagged`) to all processed links.
+
+## Usage
+
+1. **Install**: Copy the plugin files into your Shaarli plugin directory and enable it in the admin panel.
+2. **Configure**: Add your keyword-to-tag mappings in the Shaarli configuration file:
+   ```php
+   'plugins' => [
+       'AUTO_TAG_KEYWORDS' => [
+           'docker,kubernetes' => 'containers,devops',
+           'privacy,security' => 'privacy-and-security',
+           'automation,scripting' => 'automation,productivity',
+       ],
+   ],
+   ```
+## How It Works
+
+1. **Analyze**: The plugin checks the link's title, URL, description, and content for keywords.
+2. **Tag**: Matches are scored, and relevant tags are applied (up to 7 by default).
+3. **Save**: Tags are saved with the link, including the fixed `auto-tagged` tag for identification.
+
+## FAQ
+
+**What if no keywords match?**  
+No tags will be added, except for `auto-tagged`.
+
+**Can I disable auto-tagging for some links?**  
+You can manually edit the tags after saving.
+
+**Is external content stored?**  
+No, the content is analyzed only during the tagging process.
+
+## License
+
+This plugin is open-source and distributed under the [MIT License](https://opensource.org/licenses/MIT).