diff --git a/README.md b/README.md
index 94bf09f..9990cfa 100644
--- a/README.md
+++ b/README.md
@@ -33,4 +33,28 @@ tr := translate.New(cat)
 out := tr.TranslateTo("First test", language.Russian) // out == "Первая проверка"
 ```
 
-The checksum is calculated from `"First test"`.
\ No newline at end of file
+The checksum is calculated from `"First test"`.
+
+### `cmd/translate`
+
+The `cmd/translate` package contains a command that helps with creating translation files.
+
+To generate IDs corresponding to the value fields in a file, run the following:
+
+```shell
+translate gen-id <file>
+```
+
+To test your translations, run:
+
+```shell
+translate translate <dir> <lang> <string>
+```
+
+For example,
+
+```shell
+translate translate ./testdata ru "First test"
+```
+
+This should output `Первая проверка`.
\ No newline at end of file