diff --git a/README.md b/README.md
index 46b9d48..f1983c7 100644
--- a/README.md
+++ b/README.md
@@ -7,11 +7,29 @@ Keybase bot-scripting for Node.js - now written all in TypeScript! Send encrypte
 
 You can use this module to script basic Keybase commands such as sending and reading messages and attachments, and managing teams.
 
+- [Creating the bot account](#creating-the-bot-account)
 - [Installation](#installation)
 - [Hello World](#hello-world)
 - [API](#api)
 - [Contributions](#contributions)
 
+## Creating the bot account
+If that's not already done, create an account for your new bot.
+
+First create a token:
+```bash
+$ keybase bot token create
+NucJHeRHtzjCRPYprX7PFdRyebcf4Ug9
+```
+
+Then, create your bot with the token and its username, returning its paper key:
+```bash
+$ keybase bot signup -u friendlybot -t NucJHeRHtzjCRPYprX7PFdRyebcf4Ug9
+spider engine secret duck will maybe read secret message ohno act normal screwdriver fridge banana banana
+```
+
+You're all set! For other account commands, run `keybase help bot`.
+
 ## Installation
 
 1.  Install Node.js 12 or above.