diff --git a/pages/common/poetry-shell.md b/pages/common/poetry-shell.md
new file mode 100644
index 00000000000000..a9bd9c92bc666a
--- /dev/null
+++ b/pages/common/poetry-shell.md
@@ -0,0 +1,12 @@
+# poetry shell
+
+> Spawn a shell within the Poetry virtual environment.
+> More information: <https://python-poetry.org/docs/cli/#shell>.
+
+- Spawn a new shell within the project's virtual environment:
+
+`poetry shell`
+
+- Exit the spawned shell and deactivate the virtual environment:
+
+`exit`