diff --git a/.github/assets/clack-logs.png b/.github/assets/clack-logs.png
new file mode 100644
index 00000000..9ff45a8c
Binary files /dev/null and b/.github/assets/clack-logs.png differ
diff --git a/packages/prompts/README.md b/packages/prompts/README.md
index 9e8b5bf8..363b27c7 100644
--- a/packages/prompts/README.md
+++ b/packages/prompts/README.md
@@ -172,3 +172,18 @@ await p.tasks([
   },
 ]);
 ```
+
+### Logs
+
+```js
+import { log } from '@clack/prompts';
+
+log.info('Info!');
+log.success('Success!');
+log.step('Step!');
+log.warn('Warn!');
+log.error('Error!');
+log.message('Hello, World', { symbol: color.cyan('~') });
+```
+
+[clack-log-prompts](https://github.com/natemoo-re/clack/blob/main/.github/assets/clack-logs.png)