diff --git a/cmd/notation/plugin.go b/cmd/notation/plugin.go
index d5ad3ec2e..4ee8d2c94 100644
--- a/cmd/notation/plugin.go
+++ b/cmd/notation/plugin.go
@@ -19,9 +19,9 @@ func pluginCommand() *cobra.Command {
 
 func pluginListCommand() *cobra.Command {
 	return &cobra.Command{
-		Use:     "list",
+		Use:     "list [flags]",
 		Aliases: []string{"ls"},
-		Short:   "List registered plugins",
+		Short:   "List installed plugins",
 		RunE: func(cmd *cobra.Command, args []string) error {
 			return listPlugins(cmd)
 		},
diff --git a/specs/commandline/plugin.md b/specs/commandline/plugin.md
index 41dbf6f51..5e17f62ae 100644
--- a/specs/commandline/plugin.md
+++ b/specs/commandline/plugin.md
@@ -12,15 +12,13 @@ Use `notation plugin` to manage plugins. See notation [plugin documentation](htt
 Manage plugins
 
 Usage:
-  notation plugin <command>
+  notation plugin [command]
 
 Available Commands:
   list        List installed plugins
 
 Flags:
   -h, --help          help for plugin
-
-RUN 'notation plugin <command> --help' for more information on a command.
 ```
 
 ### notation plugin list