diff --git a/README.md b/README.md
index 0e3e9c2..25018ff 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,32 @@
-# visemes
-Visemes Converter Tool
+# Visemes Converter Tool
+
+A Blender add-on for generating VRChat visemes from MMD blendshapes and converting shape key names to Japanese MMD format.
+
+**Blender:** 3.0.0+
+**Category:** Rigging
+**UI Location:** View3D › Sidebar (N) › Visemes Tool
+
+---
+
+## Features
+
+- Auto-detect MMD shape keys (あ / お / い / まばたき)
+- Generate 15 standard VRChat visemes (`vrc.v_*`) + `vrc.blink`
+- Live viewport preview before generating
+- Reorder shape keys to VRChat standard order
+- Convert English/VRChat blendshape names to Japanese MMD format
+
+---
+
+## Installation
+
+1. `Edit > Preferences > Add-ons > Install`
+2. Select `visemes.py`
+3. Enable the add-on from the list
+
+---
+
+## Documentation
+
+Full documentation available here:
+[DOCUMENTATION.md](https://github.com/BluLupo/visemes/blob/main/DOCUMENTATION.md)