diff --git a/plugins/yarn/yarn.plugin.zsh b/plugins/yarn/yarn.plugin.zsh
index 47c503ac..99ba3b26 100644
--- a/plugins/yarn/yarn.plugin.zsh
+++ b/plugins/yarn/yarn.plugin.zsh
@@ -24,21 +24,21 @@ _yarn ()
     _1st_arguments=(
       'help:Display help information about yarn' \
       'init:Initialize for the development of a package.' \
-      'add:Add a package to use in your current package.' \
+      'add:<package> Add a package to use in your current package.' \
       'install:Install all the dependencies listed within package.json in the local node_modules folder.' \
       'publish:Publish a package to a package manager.' \
-      'remove:Remove a package that will no longer be used in your current package.' \
+      'remove:<package> Remove a package that will no longer be used in your current package.' \
       'cache:Clear the local cache. It will be populated again the next time yarn or yarn install is run.' \
       'clean:Frees up space by removing unnecessary files and folders from dependencies.' \
       'check:Verifies that versions of the package dependencies in the current project’s package.json matches that of yarn’s lock file.' \
-      'ls:List all installed packages.' \
+      'list:List all installed packages.' \
       'global:Makes binaries available to use on your operating system.' \
       'info:<package> [<field>] - fetch information about a package and return it in a tree format.' \
       'outdated:Checks for outdated package dependencies.' \
       'run:Runs a defined package script.' \
-      'self-update:Updates Yarn to the latest version.' \
-      'upgrade:Upgrades packages to their latest version based on the specified range.' \
-      'why:<query> - Show information about why a package is installed.'
+      'upgrade:<package> Upgrades packages to their latest version based on the specified range.' \
+      'upgrade-interactive:Opens an interactive GUI to update packages.' \
+      'why:<package> - Show information about why a package is installed.'
     )
     _arguments \
     '*:: :->subcmds' && return 0