docs: add example usage svgs using termtosvg

README.md

@@ -17,8 +17,8 @@ _**Run npm scripts using automatically shortened script names**_
 unscript [options] [query]
 ```
 
-
 ## What is unscript?
+
 Unscript lets you query and run npm scripts from a list of shorthands. These shorthands are generated from the names of the scripts in your `package.json`. Unscript creates shorthands by combining the first letter of each word separated by a delimiter (`:` by default).
 
 For example:
@@ -37,6 +37,7 @@ For example:
 If no query is passed then a list of all scripts in the `package.json` will be displayed.
 
 ## Why was this made?
+
 There are many existing tools on npm that can run javascript files easily as a drop-in replacement for package.json scripts. Although these are helpful utilities I found that I wanted to create many small package.json scripts that I wouldn't need a full javascript file for. Unscript was created out of my own personal desire to quick run npm scripts using automatically generated shortened names.
 
 ## Options
@@ -48,9 +49,15 @@ There are many existing tools on npm that can run javascript files easily as a d
 | `-a`, `--auto`      | `false` | Run the selected script without confirmation. |
 | `-s`, `--scripts`   | `false` | Display scripts in found package.json.        |
 
-## Usage
+## Installation
 
-Unscript can be run using npx:
+Unscript can be used by installing it globally
+
+```bash
+npm i -g unscript
+```
+
+or by using using npx:
 
 ```bash
 npx unscript lw
@@ -62,3 +69,27 @@ to save time writing that out it is recommended to alias the command to a shorte
 # .bashrc .zshrc ...etc
 alias un='npx unscript'
 ```
+
+## Usage
+
+### Basic usage
+
+In this case the `dev` script is run because `dev` is the only script that was automatically shortened to `d`.
+
+```
+unscript d
+```
+
+![basic shorthand example usage](examples/shorthand.svg)
+
+### Handling multiple scripts with the same generated shorthands
+
+When multiple scripts have the same generated shorthand then a prompt will appear to ask which of the results should be run.
+
+![name collision example](examples/name-collision.svg)
+
+### Run the selected script without prompting
+
+Using the `-a` (auto) option will run the selected script without prompting for confirmation if there is only one script matching the shorthand query.
+
+![auto option example](examples/auto-option.svg)