diff --git a/docs/img/smart.picker.audio.png b/docs/img/smart.picker.audio.png
new file mode 100644
index 00000000..e62dbb32
Binary files /dev/null and b/docs/img/smart.picker.audio.png differ
diff --git a/docs/img/smart.picker.image.png b/docs/img/smart.picker.image.png
new file mode 100644
index 00000000..a88b9874
Binary files /dev/null and b/docs/img/smart.picker.image.png differ
diff --git a/docs/img/smart.picker.in.text.png b/docs/img/smart.picker.in.text.png
new file mode 100644
index 00000000..c304ee32
Binary files /dev/null and b/docs/img/smart.picker.in.text.png differ
diff --git a/docs/img/smart.picker.talk.png b/docs/img/smart.picker.talk.png
new file mode 100644
index 00000000..4a6bef95
Binary files /dev/null and b/docs/img/smart.picker.talk.png differ
diff --git a/docs/img/smart.picker.text.png b/docs/img/smart.picker.text.png
new file mode 100644
index 00000000..52f08181
Binary files /dev/null and b/docs/img/smart.picker.text.png differ
diff --git a/docs/user/README.md b/docs/user/README.md
index d8a5e195..6d268b08 100644
--- a/docs/user/README.md
+++ b/docs/user/README.md
@@ -5,7 +5,9 @@
 The Assistant personal settings can be found under the "Artificial intelligence" section.
 You can disable the assistant top menu entry there. You can also disable the AI-related smart pickers.
 
-## Run a task
+## Assistant
+
+### Run a task
 
 To run a task with the Assistant, just open it via the top menu entry (on the top right).
 
@@ -22,17 +24,35 @@ You task will run immediately if possible or be scheduled for later execution.
 
 ![scheduled](../img/scheduled.png)
 
-## Notifications
+### Notifications
 
-If it is scheduled, you will receive a notification when it has finished.
+If the task was scheduled, you will receive a notification when it has finished.
 You can display the task results by clicking the "View results" button in the notification.
 
 ![notifications](../img/notifications.png)
 
-## History
+### History
 
-On the bottom left corner of the assistant, there is a button display the task history.
-This task history is filtered to only show tasks of the selected task type.
+On the bottom left corner of the assistant, there is a button to display the task history.
+This task history is filtered to only show tasks of the currently selected task type.
 You can then relaunch previous tasks, delete them or just cancel them if they were scheduled.
 
 ![task history](../img/history.png)
+
+## Smart picker
+
+The assistant app provides 3 smart pickers that you can access in Talk,
+Text and in every place where rich text edition is possible.
+To use them, type "/" and then "ai". They will appear in the filtered provider list.
+
+In Talk:
+![smart picker in talk](../img/smart.picker.talk.png)
+In Text:
+![smart picker in text](../img/smart.picker.in.text.png)
+
+The pickers:
+![smart picker image generation](../img/smart.picker.image.png)
+![smart picker audio transcription](../img/smart.picker.audio.png)
+![smart picker text generation](../img/smart.picker.text.png)
+
+If possible, the picker result will be directly inserted in the current context.