diff --git a/README.md b/README.md
index f8d502e..cc3a37b 100644
--- a/README.md
+++ b/README.md
@@ -56,6 +56,25 @@ We can also load the script in `ghci`:
 $ nix-scripti ./example.hs
 ```
 
+or open a nix-shell with the requested packages:
+
+```
+$ nix-scripts ./example.hs
+```
+
+### Supported languges
+
+|  Identifiers         | Language             |
+|:--------------------:|:---------------------|
+| `haskell`            | Haskell              |
+| `python2`, `python3` | Python               |
+| `perl`               | Perl 5               |
+| `javascript`         | JavaScript (node.js) |
+| `shell`              | Shell script (bash)  |
+
+Anything else will be treated as "passthough", meaning the rest of
+the line will be intpreted as nixpkgs attributes as-is.
+
 Contributing
 ------------