diff --git a/docs/usage.md b/docs/usage.md
index af6eb4531a2..102655e3ef8 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -735,7 +735,7 @@ _See code: [src/commands/optimize.ts](https://github.com/asyncapi/cli/blob/v2.12
 
 ## `asyncapi pretty SPEC-FILE`
 
-Format AsyncAPI specification file
+Beautify the AsyncAPI spec file (indentation, styling) in place or output the formatted spec to a new file.
 
 ```
 USAGE
diff --git a/src/commands/pretty.ts b/src/commands/pretty.ts
index 260f61c6b45..a70636032db 100644
--- a/src/commands/pretty.ts
+++ b/src/commands/pretty.ts
@@ -7,7 +7,7 @@ import { ValidationError } from '../core/errors/validation-error';
 import { prettyFlags } from '../core/flags/pretty.flags';
 
 export default class Pretty extends Command {
-  static readonly description = 'Format AsyncAPI specification file';
+  static readonly description = 'Beautify the AsyncAPI spec file (indentation, styling) in place or output the formatted spec to a new file.';
 
   static readonly examples = [
     'asyncapi pretty ./asyncapi.yaml',