Update README.md

Author: simplesagar

README.md

@@ -40,7 +40,7 @@ go install github.com/speakeasy-api/openapi-overlay@latest
 
 # Usage
 
-The tool provides the following sub-commands for working with overlay files. It can also be accessed through Speakeasy CLI command `speakeasy overlay`. Please see [here](https://www.speakeasyapi.dev/docs/speakeasy-cli/overlay/README) for CLI installation and usage documentation. 
+The tool provides sub-commands such as `apply`, `validate` and `compare` under the `openapi-overlay` command for working with overlay files. The reccomended usage pattern is through Speakeasy CLI command `speakeasy overlay`. Please see [here](https://www.speakeasyapi.dev/docs/speakeasy-cli/overlay/README) for CLI installation and usage documentation. 
 
 For more examples of usage, see [here](https://www.speakeasyapi.dev/docs/openapi/overlays)
 
@@ -49,7 +49,7 @@ For more examples of usage, see [here](https://www.speakeasyapi.dev/docs/openapi
 The most obvious use-case for this command is applying an overlay to a specification file.
 
 ```sh
-openapi-overlay apply overlay.yaml spec.yaml
+speakeasy overlay apply --overlay=overlay.yaml --schema=spec.yaml
 ```
 
 If the overlay file has the `extends` key set to a `file://` URL, then the `spec.yaml` file may be omitted.
@@ -59,18 +59,18 @@ If the overlay file has the `extends` key set to a `file://` URL, then the `spec
 A command is provided to perform basic validation of the overlay file itself. It will not tell you whether it will apply correctly or whether the application will generate a valid OpenAPI specification. Rather, it is limited to just telling you when the spec follows the OpenAPI Overlay Specification correctly: all required fields are present and have valid values.
 
 ```sh
-openapi-overlay validate overlay.yaml
+speakeasy overlay validate --overlay=overlay.yaml
 ```
 
 ## Compare
 
 Finally, a tool is provided that will generate an OpenAPI Overlay specification from two input files.
 
 ```sh
-openapi-overlay compare spec1.yaml spec2.yaml
+speakeasy overlay compare --before=spec1.yaml --after=spec2.yaml --out=overlay.yaml
 ```
 
-The overlay file will be written to stdout.
+the overlay file will be written to a file called `overlay.yaml` with a diagnostic output in the console.
 
 # Other Notes