diff --git a/cmd/docgen/docgen.go b/cmd/docgen/docgen.go
index 7cbdd591..3f101532 100644
--- a/cmd/docgen/docgen.go
+++ b/cmd/docgen/docgen.go
@@ -34,6 +34,15 @@ import (
 // defaultDocsDirPath is the default value for the <path> argument
 const defaultDocsDirPath = "docs"
 
+// commandsDocsURLPath is the docs site base path for command reference pages.
+// "See also" links must resolve against this path rather than a bare slug.
+const commandsDocsURLPath = "/tools/slack-cli/reference/commands/"
+
+// commandDocsURL returns the docs site link for a command path (e.g. "slack app").
+func commandDocsURL(commandPath string) string {
+	return commandsDocsURLPath + strings.ReplaceAll(commandPath, " ", "_") + "/"
+}
+
 //go:embed errors.tmpl
 var errorsMarkdownTemplate string
 
@@ -196,8 +205,7 @@ func genMarkdownCommand(cmd *cobra.Command, w io.Writer) error {
 		if cmd.HasParent() {
 			parent := cmd.Parent()
 			pname := parent.CommandPath()
-			link := strings.ReplaceAll(pname, " ", "_")
-			fmt.Fprintf(buf, "* [%s](%s)\t - %s\n", pname, link, parent.Short)
+			fmt.Fprintf(buf, "* [%s](%s)\t - %s\n", pname, commandDocsURL(pname), parent.Short)
 			cmd.VisitParents(func(c *cobra.Command) {
 				if c.DisableAutoGenTag {
 					cmd.DisableAutoGenTag = c.DisableAutoGenTag
@@ -217,8 +225,7 @@ func genMarkdownCommand(cmd *cobra.Command, w io.Writer) error {
 				continue
 			}
 			cname := name + " " + child.Name()
-			link := strings.ReplaceAll(cname, " ", "_")
-			fmt.Fprintf(buf, "* [%s](%s)\t - %s\n", cname, link, child.Short)
+			fmt.Fprintf(buf, "* [%s](%s)\t - %s\n", cname, commandDocsURL(cname), child.Short)
 		}
 		fmt.Fprintf(buf, "\n")
 	}
diff --git a/cmd/docgen/docgen_test.go b/cmd/docgen/docgen_test.go
index a07b081b..3e804ecf 100644
--- a/cmd/docgen/docgen_test.go
+++ b/cmd/docgen/docgen_test.go
@@ -15,6 +15,7 @@
 package docgen
 
 import (
+	"bytes"
 	"context"
 	"errors"
 	"path/filepath"
@@ -171,3 +172,47 @@ func TestNewDocsCommand(t *testing.T) {
 		return NewCommand(clients)
 	})
 }
+
+func Test_commandDocsURL(t *testing.T) {
+	tests := map[string]struct {
+		commandPath string
+		expected    string
+	}{
+		"root command": {
+			commandPath: "slack",
+			expected:    "/tools/slack-cli/reference/commands/slack/",
+		},
+		"subcommand replaces spaces with underscores": {
+			commandPath: "slack app",
+			expected:    "/tools/slack-cli/reference/commands/slack_app/",
+		},
+		"nested subcommand": {
+			commandPath: "slack app delete",
+			expected:    "/tools/slack-cli/reference/commands/slack_app_delete/",
+		},
+	}
+	for name, tc := range tests {
+		t.Run(name, func(t *testing.T) {
+			assert.Equal(t, tc.expected, commandDocsURL(tc.commandPath))
+		})
+	}
+}
+
+func Test_genMarkdownCommand(t *testing.T) {
+	root := &cobra.Command{Use: "slack", Short: "Slack command-line tool"}
+	app := &cobra.Command{Use: "app", Short: "App management commands", Run: func(*cobra.Command, []string) {}}
+	del := &cobra.Command{Use: "delete", Short: "Delete the app", Run: func(*cobra.Command, []string) {}}
+	app.AddCommand(del)
+	root.AddCommand(app)
+
+	var buf bytes.Buffer
+	require.NoError(t, genMarkdownCommand(app, &buf))
+	output := buf.String()
+
+	assert.Contains(t, output, "## See also")
+	// Parent link uses the docs site path rather than a bare slug.
+	assert.Contains(t, output, "* [slack](/tools/slack-cli/reference/commands/slack/)")
+	// Child link uses the docs site path rather than a bare slug.
+	assert.Contains(t, output, "* [slack app delete](/tools/slack-cli/reference/commands/slack_app_delete/)")
+	assert.NotContains(t, output, "](slack_app_delete)")
+}
diff --git a/docs/reference/commands/slack.md b/docs/reference/commands/slack.md
index 536ec38d..551e9fcd 100644
--- a/docs/reference/commands/slack.md
+++ b/docs/reference/commands/slack.md
@@ -41,34 +41,35 @@ $ slack docs    # Open Slack developer docs
 
 ## See also
 
-* [slack activity](slack_activity)	 - Display the app activity logs from the Slack Platform
-* [slack api](slack_api)	 - Call any Slack API method
-* [slack app](slack_app)	 - Install, uninstall, and list teams with the app installed
-* [slack auth](slack_auth)	 - Add and remove local team authorizations
-* [slack collaborator](slack_collaborator)	 - Manage app collaborators
-* [slack create](slack_create)	 - Create a new Slack project
-* [slack datastore](slack_datastore)	 - Interact with an app's datastore
-* [slack delete](slack_delete)	 - Delete the app
-* [slack deploy](slack_deploy)	 - Deploy the app to the Slack Platform
-* [slack docs](slack_docs)	 - Open Slack developer docs
-* [slack doctor](slack_doctor)	 - Check and report on system and app information
-* [slack env](slack_env)	 - Set, unset, or list environment variables
-* [slack external-auth](slack_external-auth)	 - Adjust settings of external authentication providers
-* [slack feedback](slack_feedback)	 - Share feedback about your experience or project
-* [slack function](slack_function)	 - Manage the functions of an app
-* [slack init](slack_init)	 - Initialize a project to work with the Slack CLI
-* [slack install](slack_install)	 - Install the app to a team
-* [slack list](slack_list)	 - List all authorized accounts
-* [slack login](slack_login)	 - Log in to a Slack account
-* [slack logout](slack_logout)	 - Log out of a team
-* [slack manifest](slack_manifest)	 - Print the app manifest of a project or app
-* [slack platform](slack_platform)	 - Deploy and run apps on the Slack Platform
-* [slack project](slack_project)	 - Create, manage, and doctor a project
-* [slack run](slack_run)	 - Start a local server to develop and run the app locally
-* [slack samples](slack_samples)	 - List available sample apps
-* [slack sandbox](slack_sandbox)	 - Manage developer sandboxes
-* [slack trigger](slack_trigger)	 - List details of existing triggers
-* [slack uninstall](slack_uninstall)	 - Uninstall the app from a team
-* [slack upgrade](slack_upgrade)	 - Checks for available updates to the CLI or SDK
-* [slack version](slack_version)	 - Print the version number
+* [slack activity](/tools/slack-cli/reference/commands/slack_activity/)	 - Display the app activity logs from the Slack Platform
+* [slack api](/tools/slack-cli/reference/commands/slack_api/)	 - Call any Slack API method
+* [slack app](/tools/slack-cli/reference/commands/slack_app/)	 - Install, uninstall, and list teams with the app installed
+* [slack auth](/tools/slack-cli/reference/commands/slack_auth/)	 - Add and remove local team authorizations
+* [slack blocks](/tools/slack-cli/reference/commands/slack_blocks/)	 - Build with Block Kit
+* [slack collaborator](/tools/slack-cli/reference/commands/slack_collaborator/)	 - Manage app collaborators
+* [slack create](/tools/slack-cli/reference/commands/slack_create/)	 - Create a new Slack project
+* [slack datastore](/tools/slack-cli/reference/commands/slack_datastore/)	 - Interact with an app's datastore
+* [slack delete](/tools/slack-cli/reference/commands/slack_delete/)	 - Delete the app
+* [slack deploy](/tools/slack-cli/reference/commands/slack_deploy/)	 - Deploy the app to the Slack Platform
+* [slack docs](/tools/slack-cli/reference/commands/slack_docs/)	 - Open Slack developer docs
+* [slack doctor](/tools/slack-cli/reference/commands/slack_doctor/)	 - Check and report on system and app information
+* [slack env](/tools/slack-cli/reference/commands/slack_env/)	 - Set, unset, or list environment variables
+* [slack external-auth](/tools/slack-cli/reference/commands/slack_external-auth/)	 - Adjust settings of external authentication providers
+* [slack feedback](/tools/slack-cli/reference/commands/slack_feedback/)	 - Share feedback about your experience or project
+* [slack function](/tools/slack-cli/reference/commands/slack_function/)	 - Manage the functions of an app
+* [slack init](/tools/slack-cli/reference/commands/slack_init/)	 - Initialize a project to work with the Slack CLI
+* [slack install](/tools/slack-cli/reference/commands/slack_install/)	 - Install the app to a team
+* [slack list](/tools/slack-cli/reference/commands/slack_list/)	 - List all authorized accounts
+* [slack login](/tools/slack-cli/reference/commands/slack_login/)	 - Log in to a Slack account
+* [slack logout](/tools/slack-cli/reference/commands/slack_logout/)	 - Log out of a team
+* [slack manifest](/tools/slack-cli/reference/commands/slack_manifest/)	 - Print the app manifest of a project or app
+* [slack platform](/tools/slack-cli/reference/commands/slack_platform/)	 - Deploy and run apps on the Slack Platform
+* [slack project](/tools/slack-cli/reference/commands/slack_project/)	 - Create, manage, and doctor a project
+* [slack run](/tools/slack-cli/reference/commands/slack_run/)	 - Start a local server to develop and run the app locally
+* [slack samples](/tools/slack-cli/reference/commands/slack_samples/)	 - List available sample apps
+* [slack sandbox](/tools/slack-cli/reference/commands/slack_sandbox/)	 - Manage developer sandboxes
+* [slack trigger](/tools/slack-cli/reference/commands/slack_trigger/)	 - List details of existing triggers
+* [slack uninstall](/tools/slack-cli/reference/commands/slack_uninstall/)	 - Uninstall the app from a team
+* [slack upgrade](/tools/slack-cli/reference/commands/slack_upgrade/)	 - Checks for available updates to the CLI or SDK
+* [slack version](/tools/slack-cli/reference/commands/slack_version/)	 - Print the version number
 
diff --git a/docs/reference/commands/slack_activity.md b/docs/reference/commands/slack_activity.md
index 94a36e61..f885ed51 100644
--- a/docs/reference/commands/slack_activity.md
+++ b/docs/reference/commands/slack_activity.md
@@ -57,5 +57,5 @@ $ slack platform activity -t  # Continuously poll for new activity logs
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
 
diff --git a/docs/reference/commands/slack_api.md b/docs/reference/commands/slack_api.md
index 753faa24..711ba418 100644
--- a/docs/reference/commands/slack_api.md
+++ b/docs/reference/commands/slack_api.md
@@ -129,5 +129,5 @@ $ slack api views.update view_id=V0123456 view={...}
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
 
diff --git a/docs/reference/commands/slack_app.md b/docs/reference/commands/slack_app.md
index 5a7a9f95..781023ac 100644
--- a/docs/reference/commands/slack_app.md
+++ b/docs/reference/commands/slack_app.md
@@ -45,12 +45,12 @@ $ slack app delete     # Delete an app and app info from a team
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
-* [slack app delete](slack_app_delete)	 - Delete the app
-* [slack app install](slack_app_install)	 - Install the app to a team
-* [slack app link](slack_app_link)	 - Add an existing app to the project
-* [slack app list](slack_app_list)	 - List teams with the app installed
-* [slack app settings](slack_app_settings)	 - Open app settings for configurations
-* [slack app uninstall](slack_app_uninstall)	 - Uninstall the app from a team
-* [slack app unlink](slack_app_unlink)	 - Remove a linked app from the project
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
+* [slack app delete](/tools/slack-cli/reference/commands/slack_app_delete/)	 - Delete the app
+* [slack app install](/tools/slack-cli/reference/commands/slack_app_install/)	 - Install the app to a team
+* [slack app link](/tools/slack-cli/reference/commands/slack_app_link/)	 - Add an existing app to the project
+* [slack app list](/tools/slack-cli/reference/commands/slack_app_list/)	 - List teams with the app installed
+* [slack app settings](/tools/slack-cli/reference/commands/slack_app_settings/)	 - Open app settings for configurations
+* [slack app uninstall](/tools/slack-cli/reference/commands/slack_app_uninstall/)	 - Uninstall the app from a team
+* [slack app unlink](/tools/slack-cli/reference/commands/slack_app_unlink/)	 - Remove a linked app from the project
 
diff --git a/docs/reference/commands/slack_app_delete.md b/docs/reference/commands/slack_app_delete.md
index 4309d471..49ed5db2 100644
--- a/docs/reference/commands/slack_app_delete.md
+++ b/docs/reference/commands/slack_app_delete.md
@@ -43,5 +43,5 @@ $ slack app delete --team T0123456 --app local
 
 ## See also
 
-* [slack app](slack_app)	 - Install, uninstall, and list teams with the app installed
+* [slack app](/tools/slack-cli/reference/commands/slack_app/)	 - Install, uninstall, and list teams with the app installed
 
diff --git a/docs/reference/commands/slack_app_install.md b/docs/reference/commands/slack_app_install.md
index 4df029d6..407b60c7 100644
--- a/docs/reference/commands/slack_app_install.md
+++ b/docs/reference/commands/slack_app_install.md
@@ -49,5 +49,5 @@ $ slack app install --team T0123456 --environment local
 
 ## See also
 
-* [slack app](slack_app)	 - Install, uninstall, and list teams with the app installed
+* [slack app](/tools/slack-cli/reference/commands/slack_app/)	 - Install, uninstall, and list teams with the app installed
 
diff --git a/docs/reference/commands/slack_app_link.md b/docs/reference/commands/slack_app_link.md
index da77a4ce..08ceee43 100644
--- a/docs/reference/commands/slack_app_link.md
+++ b/docs/reference/commands/slack_app_link.md
@@ -53,5 +53,5 @@ $ slack app link --team T0123456789 --app A0123456789 --environment deployed
 
 ## See also
 
-* [slack app](slack_app)	 - Install, uninstall, and list teams with the app installed
+* [slack app](/tools/slack-cli/reference/commands/slack_app/)	 - Install, uninstall, and list teams with the app installed
 
diff --git a/docs/reference/commands/slack_app_list.md b/docs/reference/commands/slack_app_list.md
index b21a14ed..d123e32c 100644
--- a/docs/reference/commands/slack_app_list.md
+++ b/docs/reference/commands/slack_app_list.md
@@ -41,5 +41,5 @@ $ slack app list  # List all teams with the app installed
 
 ## See also
 
-* [slack app](slack_app)	 - Install, uninstall, and list teams with the app installed
+* [slack app](/tools/slack-cli/reference/commands/slack_app/)	 - Install, uninstall, and list teams with the app installed
 
diff --git a/docs/reference/commands/slack_app_settings.md b/docs/reference/commands/slack_app_settings.md
index dd1a5678..7162b785 100644
--- a/docs/reference/commands/slack_app_settings.md
+++ b/docs/reference/commands/slack_app_settings.md
@@ -47,5 +47,5 @@ $ slack app settings --app A0123456789
 
 ## See also
 
-* [slack app](slack_app)	 - Install, uninstall, and list teams with the app installed
+* [slack app](/tools/slack-cli/reference/commands/slack_app/)	 - Install, uninstall, and list teams with the app installed
 
diff --git a/docs/reference/commands/slack_app_uninstall.md b/docs/reference/commands/slack_app_uninstall.md
index 67628a1f..c73fdb5a 100644
--- a/docs/reference/commands/slack_app_uninstall.md
+++ b/docs/reference/commands/slack_app_uninstall.md
@@ -39,5 +39,5 @@ $ slack app uninstall  # Uninstall an app from a team
 
 ## See also
 
-* [slack app](slack_app)	 - Install, uninstall, and list teams with the app installed
+* [slack app](/tools/slack-cli/reference/commands/slack_app/)	 - Install, uninstall, and list teams with the app installed
 
diff --git a/docs/reference/commands/slack_app_unlink.md b/docs/reference/commands/slack_app_unlink.md
index 3cd34799..7cf64347 100644
--- a/docs/reference/commands/slack_app_unlink.md
+++ b/docs/reference/commands/slack_app_unlink.md
@@ -46,5 +46,5 @@ $ slack app unlink --app A0123456789
 
 ## See also
 
-* [slack app](slack_app)	 - Install, uninstall, and list teams with the app installed
+* [slack app](/tools/slack-cli/reference/commands/slack_app/)	 - Install, uninstall, and list teams with the app installed
 
diff --git a/docs/reference/commands/slack_auth.md b/docs/reference/commands/slack_auth.md
index 5744ae08..4762c3b0 100644
--- a/docs/reference/commands/slack_auth.md
+++ b/docs/reference/commands/slack_auth.md
@@ -41,10 +41,10 @@ $ slack auth logout  # Log out of a team
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
-* [slack auth list](slack_auth_list)	 - List all authorized accounts
-* [slack auth login](slack_auth_login)	 - Log in to a Slack account
-* [slack auth logout](slack_auth_logout)	 - Log out of a team
-* [slack auth revoke](slack_auth_revoke)	 - Revoke an authentication token
-* [slack auth token](slack_auth_token)	 - Collect a service token
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
+* [slack auth list](/tools/slack-cli/reference/commands/slack_auth_list/)	 - List all authorized accounts
+* [slack auth login](/tools/slack-cli/reference/commands/slack_auth_login/)	 - Log in to a Slack account
+* [slack auth logout](/tools/slack-cli/reference/commands/slack_auth_logout/)	 - Log out of a team
+* [slack auth revoke](/tools/slack-cli/reference/commands/slack_auth_revoke/)	 - Revoke an authentication token
+* [slack auth token](/tools/slack-cli/reference/commands/slack_auth_token/)	 - Collect a service token
 
diff --git a/docs/reference/commands/slack_auth_list.md b/docs/reference/commands/slack_auth_list.md
index bd328ea6..5a070278 100644
--- a/docs/reference/commands/slack_auth_list.md
+++ b/docs/reference/commands/slack_auth_list.md
@@ -39,5 +39,5 @@ $ slack auth list  # List all authorized accounts
 
 ## See also
 
-* [slack auth](slack_auth)	 - Add and remove local team authorizations
+* [slack auth](/tools/slack-cli/reference/commands/slack_auth/)	 - Add and remove local team authorizations
 
diff --git a/docs/reference/commands/slack_auth_login.md b/docs/reference/commands/slack_auth_login.md
index e501fb3c..7f1f75c2 100644
--- a/docs/reference/commands/slack_auth_login.md
+++ b/docs/reference/commands/slack_auth_login.md
@@ -52,5 +52,5 @@ $ slack auth login --token xoxp-...
 
 ## See also
 
-* [slack auth](slack_auth)	 - Add and remove local team authorizations
+* [slack auth](/tools/slack-cli/reference/commands/slack_auth/)	 - Add and remove local team authorizations
 
diff --git a/docs/reference/commands/slack_auth_logout.md b/docs/reference/commands/slack_auth_logout.md
index 9481d2ff..1d940f16 100644
--- a/docs/reference/commands/slack_auth_logout.md
+++ b/docs/reference/commands/slack_auth_logout.md
@@ -41,5 +41,5 @@ $ slack auth logout --all  # Log out of all team
 
 ## See also
 
-* [slack auth](slack_auth)	 - Add and remove local team authorizations
+* [slack auth](/tools/slack-cli/reference/commands/slack_auth/)	 - Add and remove local team authorizations
 
diff --git a/docs/reference/commands/slack_auth_revoke.md b/docs/reference/commands/slack_auth_revoke.md
index 02a71666..f05edb74 100644
--- a/docs/reference/commands/slack_auth_revoke.md
+++ b/docs/reference/commands/slack_auth_revoke.md
@@ -39,5 +39,5 @@ $ slack auth revoke --token xoxp-1-4921830...  # Revoke a service token
 
 ## See also
 
-* [slack auth](slack_auth)	 - Add and remove local team authorizations
+* [slack auth](/tools/slack-cli/reference/commands/slack_auth/)	 - Add and remove local team authorizations
 
diff --git a/docs/reference/commands/slack_auth_token.md b/docs/reference/commands/slack_auth_token.md
index 27664d77..a232dfb5 100644
--- a/docs/reference/commands/slack_auth_token.md
+++ b/docs/reference/commands/slack_auth_token.md
@@ -49,5 +49,5 @@ $ slack auth token --challenge 6d0a31c9 --ticket ISQWLiZT0OtMLO3YWNTJO0...
 
 ## See also
 
-* [slack auth](slack_auth)	 - Add and remove local team authorizations
+* [slack auth](/tools/slack-cli/reference/commands/slack_auth/)	 - Add and remove local team authorizations
 
diff --git a/docs/reference/commands/slack_blocks.md b/docs/reference/commands/slack_blocks.md
new file mode 100644
index 00000000..ed0d32ba
--- /dev/null
+++ b/docs/reference/commands/slack_blocks.md
@@ -0,0 +1,45 @@
+# `slack blocks`
+
+Build with Block Kit
+
+## Description
+
+Build layouts using Block Kit and iterate on designs with Block Kit Builder.
+
+```
+slack blocks <subcommand> [flags]
+```
+
+## Flags
+
+```
+  -h, --help   help for blocks
+```
+
+## Global flags
+
+```
+      --accessible           use accessible prompts for screen readers
+  -a, --app string           use a specific app ID or environment
+      --config-dir string    use a custom path for system config directory
+  -e, --experiment strings   use the experiment(s) in the command
+  -f, --force                ignore warnings and continue executing command
+      --no-color             remove styles and formatting from outputs
+  -s, --skip-update          skip checking for latest version of CLI
+  -w, --team string          select workspace or organization by team name or ID
+      --token string         set the access token associated with a team
+  -v, --verbose              print debug logging and additional info
+```
+
+## Examples
+
+```
+# Preview blocks in Block Kit Builder
+$ slack blocks preview --blocks '[{"type":"divider"}]'
+```
+
+## See also
+
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
+* [slack blocks preview](/tools/slack-cli/reference/commands/slack_blocks_preview/)	 - Preview blocks in Block Kit Builder
+
diff --git a/docs/reference/commands/slack_blocks_preview.md b/docs/reference/commands/slack_blocks_preview.md
new file mode 100644
index 00000000..7f21343e
--- /dev/null
+++ b/docs/reference/commands/slack_blocks_preview.md
@@ -0,0 +1,56 @@
+# `slack blocks preview`
+
+Preview blocks in Block Kit Builder
+
+## Description
+
+Preview a set of Block Kit blocks with Block Kit Builder in a web browser.
+
+Provide blocks with the --blocks flag.
+The input is a JSON array of blocks or a JSON object with a "blocks" array.
+Pass - to --blocks, or omit all flags, to read from standard input.
+
+```
+slack blocks preview [flags]
+```
+
+## Flags
+
+```
+      --blocks string   blocks to preview as a JSON array or object
+                          (use - to read from standard input)
+  -h, --help            help for preview
+```
+
+## Global flags
+
+```
+      --accessible           use accessible prompts for screen readers
+  -a, --app string           use a specific app ID or environment
+      --config-dir string    use a custom path for system config directory
+  -e, --experiment strings   use the experiment(s) in the command
+  -f, --force                ignore warnings and continue executing command
+      --no-color             remove styles and formatting from outputs
+  -s, --skip-update          skip checking for latest version of CLI
+  -w, --team string          select workspace or organization by team name or ID
+      --token string         set the access token associated with a team
+  -v, --verbose              print debug logging and additional info
+```
+
+## Examples
+
+```
+# Preview blocks passed as a flag value
+$ slack blocks preview --blocks '[{"type":"divider"}]'
+
+# Preview blocks read from a file
+$ slack blocks preview < blocks.json
+
+# Preview blocks read from a redirect and scoped to a team
+$ slack blocks preview --team T0123456 --blocks - < blocks.json
+```
+
+## See also
+
+* [slack blocks](/tools/slack-cli/reference/commands/slack_blocks/)	 - Build with Block Kit
+
diff --git a/docs/reference/commands/slack_collaborator.md b/docs/reference/commands/slack_collaborator.md
index 101de19b..c3a5535b 100644
--- a/docs/reference/commands/slack_collaborator.md
+++ b/docs/reference/commands/slack_collaborator.md
@@ -43,8 +43,8 @@ $ slack collaborator remove USLACKBOT
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
-* [slack collaborator add](slack_collaborator_add)	 - Add a new collaborator to the app
-* [slack collaborator list](slack_collaborator_list)	 - List all collaborators of an app
-* [slack collaborator remove](slack_collaborator_remove)	 - Remove a collaborator from an app
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
+* [slack collaborator add](/tools/slack-cli/reference/commands/slack_collaborator_add/)	 - Add a new collaborator to the app
+* [slack collaborator list](/tools/slack-cli/reference/commands/slack_collaborator_list/)	 - List all collaborators of an app
+* [slack collaborator remove](/tools/slack-cli/reference/commands/slack_collaborator_remove/)	 - Remove a collaborator from an app
 
diff --git a/docs/reference/commands/slack_collaborator_add.md b/docs/reference/commands/slack_collaborator_add.md
index 0bf6daa1..819d8fd0 100644
--- a/docs/reference/commands/slack_collaborator_add.md
+++ b/docs/reference/commands/slack_collaborator_add.md
@@ -43,5 +43,5 @@ $ slack collaborator add USLACKBOT      # Add a collaborator by user ID
 
 ## See also
 
-* [slack collaborator](slack_collaborator)	 - Manage app collaborators
+* [slack collaborator](/tools/slack-cli/reference/commands/slack_collaborator/)	 - Manage app collaborators
 
diff --git a/docs/reference/commands/slack_collaborator_list.md b/docs/reference/commands/slack_collaborator_list.md
index a9a525f8..62eff413 100644
--- a/docs/reference/commands/slack_collaborator_list.md
+++ b/docs/reference/commands/slack_collaborator_list.md
@@ -39,5 +39,5 @@ $ slack collaborator list  # List all of the collaborators
 
 ## See also
 
-* [slack collaborator](slack_collaborator)	 - Manage app collaborators
+* [slack collaborator](/tools/slack-cli/reference/commands/slack_collaborator/)	 - Manage app collaborators
 
diff --git a/docs/reference/commands/slack_collaborator_remove.md b/docs/reference/commands/slack_collaborator_remove.md
index dfc1bf5d..fed67b29 100644
--- a/docs/reference/commands/slack_collaborator_remove.md
+++ b/docs/reference/commands/slack_collaborator_remove.md
@@ -41,5 +41,5 @@ $ slack collaborator remove USLACKBOT      # Remove collaborator using ID
 
 ## See also
 
-* [slack collaborator](slack_collaborator)	 - Manage app collaborators
+* [slack collaborator](/tools/slack-cli/reference/commands/slack_collaborator/)	 - Manage app collaborators
 
diff --git a/docs/reference/commands/slack_create.md b/docs/reference/commands/slack_create.md
index 7b274c36..cc58dcc2 100644
--- a/docs/reference/commands/slack_create.md
+++ b/docs/reference/commands/slack_create.md
@@ -64,5 +64,5 @@ $ slack create my-project -t slack-samples/bolt-js-starter-template --app A01234
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
 
diff --git a/docs/reference/commands/slack_datastore.md b/docs/reference/commands/slack_datastore.md
index b4a139d2..bdea5017 100644
--- a/docs/reference/commands/slack_datastore.md
+++ b/docs/reference/commands/slack_datastore.md
@@ -69,14 +69,14 @@ $ slack datastore count --datastore tasks
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
-* [slack datastore bulk-delete](slack_datastore_bulk-delete)	 - Delete multiple items from a datastore
-* [slack datastore bulk-get](slack_datastore_bulk-get)	 - Get multiple items from a datastore
-* [slack datastore bulk-put](slack_datastore_bulk-put)	 - Create or replace a list of items in a datastore
-* [slack datastore count](slack_datastore_count)	 - Count the number of items in a datastore
-* [slack datastore delete](slack_datastore_delete)	 - Delete an item from a datastore
-* [slack datastore get](slack_datastore_get)	 - Get an item from a datastore
-* [slack datastore put](slack_datastore_put)	 - Create or replace an item in a datastore
-* [slack datastore query](slack_datastore_query)	 - Query a datastore for items
-* [slack datastore update](slack_datastore_update)	 - Create or update an item in a datastore
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
+* [slack datastore bulk-delete](/tools/slack-cli/reference/commands/slack_datastore_bulk-delete/)	 - Delete multiple items from a datastore
+* [slack datastore bulk-get](/tools/slack-cli/reference/commands/slack_datastore_bulk-get/)	 - Get multiple items from a datastore
+* [slack datastore bulk-put](/tools/slack-cli/reference/commands/slack_datastore_bulk-put/)	 - Create or replace a list of items in a datastore
+* [slack datastore count](/tools/slack-cli/reference/commands/slack_datastore_count/)	 - Count the number of items in a datastore
+* [slack datastore delete](/tools/slack-cli/reference/commands/slack_datastore_delete/)	 - Delete an item from a datastore
+* [slack datastore get](/tools/slack-cli/reference/commands/slack_datastore_get/)	 - Get an item from a datastore
+* [slack datastore put](/tools/slack-cli/reference/commands/slack_datastore_put/)	 - Create or replace an item in a datastore
+* [slack datastore query](/tools/slack-cli/reference/commands/slack_datastore_query/)	 - Query a datastore for items
+* [slack datastore update](/tools/slack-cli/reference/commands/slack_datastore_update/)	 - Create or update an item in a datastore
 
diff --git a/docs/reference/commands/slack_datastore_bulk-delete.md b/docs/reference/commands/slack_datastore_bulk-delete.md
index 5578369f..18911432 100644
--- a/docs/reference/commands/slack_datastore_bulk-delete.md
+++ b/docs/reference/commands/slack_datastore_bulk-delete.md
@@ -49,5 +49,5 @@ $ slack datastore bulk-delete '{"datastore": "tasks", "ids": ["12", "42"]}'
 
 ## See also
 
-* [slack datastore](slack_datastore)	 - Interact with an app's datastore
+* [slack datastore](/tools/slack-cli/reference/commands/slack_datastore/)	 - Interact with an app's datastore
 
diff --git a/docs/reference/commands/slack_datastore_bulk-get.md b/docs/reference/commands/slack_datastore_bulk-get.md
index e37881ed..bf4ca270 100644
--- a/docs/reference/commands/slack_datastore_bulk-get.md
+++ b/docs/reference/commands/slack_datastore_bulk-get.md
@@ -50,5 +50,5 @@ $ slack datastore bulk-get '{"datastore": "tasks", "ids": ["12", "42"]}'
 
 ## See also
 
-* [slack datastore](slack_datastore)	 - Interact with an app's datastore
+* [slack datastore](/tools/slack-cli/reference/commands/slack_datastore/)	 - Interact with an app's datastore
 
diff --git a/docs/reference/commands/slack_datastore_bulk-put.md b/docs/reference/commands/slack_datastore_bulk-put.md
index 14fa9340..722cf15a 100644
--- a/docs/reference/commands/slack_datastore_bulk-put.md
+++ b/docs/reference/commands/slack_datastore_bulk-put.md
@@ -50,5 +50,5 @@ $ slack datastore bulk-put '{"datastore": "tasks", "items": [{"id": "12", "descr
 
 ## See also
 
-* [slack datastore](slack_datastore)	 - Interact with an app's datastore
+* [slack datastore](/tools/slack-cli/reference/commands/slack_datastore/)	 - Interact with an app's datastore
 
diff --git a/docs/reference/commands/slack_datastore_count.md b/docs/reference/commands/slack_datastore_count.md
index ad2bd3a1..b0acb35f 100644
--- a/docs/reference/commands/slack_datastore_count.md
+++ b/docs/reference/commands/slack_datastore_count.md
@@ -50,5 +50,5 @@ $ slack datastore count '{"datastore": "tasks", "expression": "#status = :status
 
 ## See also
 
-* [slack datastore](slack_datastore)	 - Interact with an app's datastore
+* [slack datastore](/tools/slack-cli/reference/commands/slack_datastore/)	 - Interact with an app's datastore
 
diff --git a/docs/reference/commands/slack_datastore_delete.md b/docs/reference/commands/slack_datastore_delete.md
index 18f0e34c..6a67b345 100644
--- a/docs/reference/commands/slack_datastore_delete.md
+++ b/docs/reference/commands/slack_datastore_delete.md
@@ -49,5 +49,5 @@ $ slack datastore delete '{"datastore": "tasks", "id": "42"}'
 
 ## See also
 
-* [slack datastore](slack_datastore)	 - Interact with an app's datastore
+* [slack datastore](/tools/slack-cli/reference/commands/slack_datastore/)	 - Interact with an app's datastore
 
diff --git a/docs/reference/commands/slack_datastore_get.md b/docs/reference/commands/slack_datastore_get.md
index 27d98dbc..c8e3c54c 100644
--- a/docs/reference/commands/slack_datastore_get.md
+++ b/docs/reference/commands/slack_datastore_get.md
@@ -50,5 +50,5 @@ $ slack datastore get '{"datastore": "tasks", "id": "42"}'
 
 ## See also
 
-* [slack datastore](slack_datastore)	 - Interact with an app's datastore
+* [slack datastore](/tools/slack-cli/reference/commands/slack_datastore/)	 - Interact with an app's datastore
 
diff --git a/docs/reference/commands/slack_datastore_put.md b/docs/reference/commands/slack_datastore_put.md
index 8f0f7849..75d42b24 100644
--- a/docs/reference/commands/slack_datastore_put.md
+++ b/docs/reference/commands/slack_datastore_put.md
@@ -49,5 +49,5 @@ $ slack datastore put '{"datastore": "tasks", "item": {"id": "42", "description"
 
 ## See also
 
-* [slack datastore](slack_datastore)	 - Interact with an app's datastore
+* [slack datastore](/tools/slack-cli/reference/commands/slack_datastore/)	 - Interact with an app's datastore
 
diff --git a/docs/reference/commands/slack_datastore_query.md b/docs/reference/commands/slack_datastore_query.md
index 816675f4..e6532041 100644
--- a/docs/reference/commands/slack_datastore_query.md
+++ b/docs/reference/commands/slack_datastore_query.md
@@ -57,5 +57,5 @@ $ slack datastore query '{"datastore": "tasks", "expression": "#status = :status
 
 ## See also
 
-* [slack datastore](slack_datastore)	 - Interact with an app's datastore
+* [slack datastore](/tools/slack-cli/reference/commands/slack_datastore/)	 - Interact with an app's datastore
 
diff --git a/docs/reference/commands/slack_datastore_update.md b/docs/reference/commands/slack_datastore_update.md
index 43d66f7d..e799aca2 100644
--- a/docs/reference/commands/slack_datastore_update.md
+++ b/docs/reference/commands/slack_datastore_update.md
@@ -49,5 +49,5 @@ $ slack datastore update '{"datastore": "tasks", "item": {"id": "42", "descripti
 
 ## See also
 
-* [slack datastore](slack_datastore)	 - Interact with an app's datastore
+* [slack datastore](/tools/slack-cli/reference/commands/slack_datastore/)	 - Interact with an app's datastore
 
diff --git a/docs/reference/commands/slack_delete.md b/docs/reference/commands/slack_delete.md
index ec5a2149..e0ad6656 100644
--- a/docs/reference/commands/slack_delete.md
+++ b/docs/reference/commands/slack_delete.md
@@ -43,5 +43,5 @@ $ slack app delete --team T0123456 --app local
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
 
diff --git a/docs/reference/commands/slack_deploy.md b/docs/reference/commands/slack_deploy.md
index 10f06f10..02a63f39 100644
--- a/docs/reference/commands/slack_deploy.md
+++ b/docs/reference/commands/slack_deploy.md
@@ -44,5 +44,5 @@ $ slack platform deploy --team T0123456  # Deploy to a specific team
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
 
diff --git a/docs/reference/commands/slack_docs.md b/docs/reference/commands/slack_docs.md
index 3907c1e0..a476e86d 100644
--- a/docs/reference/commands/slack_docs.md
+++ b/docs/reference/commands/slack_docs.md
@@ -46,6 +46,6 @@ $ slack docs search "Block Kit" --output=browser
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
-* [slack docs search](slack_docs_search)	 - Search Slack developer docs
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
+* [slack docs search](/tools/slack-cli/reference/commands/slack_docs_search/)	 - Search Slack developer docs
 
diff --git a/docs/reference/commands/slack_docs_search.md b/docs/reference/commands/slack_docs_search.md
index 8a56b476..b4e62c0d 100644
--- a/docs/reference/commands/slack_docs_search.md
+++ b/docs/reference/commands/slack_docs_search.md
@@ -56,5 +56,5 @@ $ slack docs search "chat.postMessage" --category=reference
 
 ## See also
 
-* [slack docs](slack_docs)	 - Open Slack developer docs
+* [slack docs](/tools/slack-cli/reference/commands/slack_docs/)	 - Open Slack developer docs
 
diff --git a/docs/reference/commands/slack_doctor.md b/docs/reference/commands/slack_doctor.md
index fff3a360..68188aac 100644
--- a/docs/reference/commands/slack_doctor.md
+++ b/docs/reference/commands/slack_doctor.md
@@ -48,5 +48,5 @@ $ slack doctor  # Create a status report of system dependencies
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
 
diff --git a/docs/reference/commands/slack_env.md b/docs/reference/commands/slack_env.md
index 5f6d0434..91e235da 100644
--- a/docs/reference/commands/slack_env.md
+++ b/docs/reference/commands/slack_env.md
@@ -53,9 +53,9 @@ $ slack env unset MAGIC_PASSWORD           # Unset an environment variable
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
-* [slack env init](slack_env_init)	 - Initialize environment variables from a template file
-* [slack env list](slack_env_list)	 - List all environment variables of the project
-* [slack env set](slack_env_set)	 - Set an environment variable for the project
-* [slack env unset](slack_env_unset)	 - Unset an environment variable from the project
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
+* [slack env init](/tools/slack-cli/reference/commands/slack_env_init/)	 - Initialize environment variables from a template file
+* [slack env list](/tools/slack-cli/reference/commands/slack_env_list/)	 - List all environment variables of the project
+* [slack env set](/tools/slack-cli/reference/commands/slack_env_set/)	 - Set an environment variable for the project
+* [slack env unset](/tools/slack-cli/reference/commands/slack_env_unset/)	 - Unset an environment variable from the project
 
diff --git a/docs/reference/commands/slack_env_init.md b/docs/reference/commands/slack_env_init.md
index ba5e9eae..fb4cc56e 100644
--- a/docs/reference/commands/slack_env_init.md
+++ b/docs/reference/commands/slack_env_init.md
@@ -44,5 +44,5 @@ $ slack env init  # Initialize environment variables from a template file
 
 ## See also
 
-* [slack env](slack_env)	 - Set, unset, or list environment variables
+* [slack env](/tools/slack-cli/reference/commands/slack_env/)	 - Set, unset, or list environment variables
 
diff --git a/docs/reference/commands/slack_env_list.md b/docs/reference/commands/slack_env_list.md
index 395faf57..b78b5671 100644
--- a/docs/reference/commands/slack_env_list.md
+++ b/docs/reference/commands/slack_env_list.md
@@ -45,5 +45,5 @@ $ slack env list  # List all environment variables
 
 ## See also
 
-* [slack env](slack_env)	 - Set, unset, or list environment variables
+* [slack env](/tools/slack-cli/reference/commands/slack_env/)	 - Set, unset, or list environment variables
 
diff --git a/docs/reference/commands/slack_env_set.md b/docs/reference/commands/slack_env_set.md
index ffea4254..417d82a3 100644
--- a/docs/reference/commands/slack_env_set.md
+++ b/docs/reference/commands/slack_env_set.md
@@ -53,5 +53,5 @@ $ slack env set SECRET_PASSWORD
 
 ## See also
 
-* [slack env](slack_env)	 - Set, unset, or list environment variables
+* [slack env](/tools/slack-cli/reference/commands/slack_env/)	 - Set, unset, or list environment variables
 
diff --git a/docs/reference/commands/slack_env_unset.md b/docs/reference/commands/slack_env_unset.md
index d65f0a63..7c81d840 100644
--- a/docs/reference/commands/slack_env_unset.md
+++ b/docs/reference/commands/slack_env_unset.md
@@ -50,5 +50,5 @@ $ slack env unset MAGIC_PASSWORD  # Unset an environment variable
 
 ## See also
 
-* [slack env](slack_env)	 - Set, unset, or list environment variables
+* [slack env](/tools/slack-cli/reference/commands/slack_env/)	 - Set, unset, or list environment variables
 
diff --git a/docs/reference/commands/slack_external-auth.md b/docs/reference/commands/slack_external-auth.md
index 69a9a56e..3c577dc8 100644
--- a/docs/reference/commands/slack_external-auth.md
+++ b/docs/reference/commands/slack_external-auth.md
@@ -54,9 +54,9 @@ $ slack external-auth select-auth
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
-* [slack external-auth add](slack_external-auth_add)	 - Initiate the OAuth2 flow for a provider
-* [slack external-auth add-secret](slack_external-auth_add-secret)	 - Add the client secret for a provider
-* [slack external-auth remove](slack_external-auth_remove)	 - Remove the saved tokens for a provider
-* [slack external-auth select-auth](slack_external-auth_select-auth)	 - Select developer authentication of a workflow
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
+* [slack external-auth add](/tools/slack-cli/reference/commands/slack_external-auth_add/)	 - Initiate the OAuth2 flow for a provider
+* [slack external-auth add-secret](/tools/slack-cli/reference/commands/slack_external-auth_add-secret/)	 - Add the client secret for a provider
+* [slack external-auth remove](/tools/slack-cli/reference/commands/slack_external-auth_remove/)	 - Remove the saved tokens for a provider
+* [slack external-auth select-auth](/tools/slack-cli/reference/commands/slack_external-auth_select-auth/)	 - Select developer authentication of a workflow
 
diff --git a/docs/reference/commands/slack_external-auth_add-secret.md b/docs/reference/commands/slack_external-auth_add-secret.md
index 70e777ac..cb70b427 100644
--- a/docs/reference/commands/slack_external-auth_add-secret.md
+++ b/docs/reference/commands/slack_external-auth_add-secret.md
@@ -47,5 +47,5 @@ $ slack external-auth add-secret -p github -x ghp_token
 
 ## See also
 
-* [slack external-auth](slack_external-auth)	 - Adjust settings of external authentication providers
+* [slack external-auth](/tools/slack-cli/reference/commands/slack_external-auth/)	 - Adjust settings of external authentication providers
 
diff --git a/docs/reference/commands/slack_external-auth_add.md b/docs/reference/commands/slack_external-auth_add.md
index dece833f..fc0a3329 100644
--- a/docs/reference/commands/slack_external-auth_add.md
+++ b/docs/reference/commands/slack_external-auth_add.md
@@ -47,5 +47,5 @@ $ slack external-auth add -p github
 
 ## See also
 
-* [slack external-auth](slack_external-auth)	 - Adjust settings of external authentication providers
+* [slack external-auth](/tools/slack-cli/reference/commands/slack_external-auth/)	 - Adjust settings of external authentication providers
 
diff --git a/docs/reference/commands/slack_external-auth_remove.md b/docs/reference/commands/slack_external-auth_remove.md
index a8bd6cb8..8cb1a023 100644
--- a/docs/reference/commands/slack_external-auth_remove.md
+++ b/docs/reference/commands/slack_external-auth_remove.md
@@ -57,5 +57,5 @@ $ slack external-auth remove --all
 
 ## See also
 
-* [slack external-auth](slack_external-auth)	 - Adjust settings of external authentication providers
+* [slack external-auth](/tools/slack-cli/reference/commands/slack_external-auth/)	 - Adjust settings of external authentication providers
 
diff --git a/docs/reference/commands/slack_external-auth_select-auth.md b/docs/reference/commands/slack_external-auth_select-auth.md
index 3ce069a7..48aedeca 100644
--- a/docs/reference/commands/slack_external-auth_select-auth.md
+++ b/docs/reference/commands/slack_external-auth_select-auth.md
@@ -47,5 +47,5 @@ $ slack external-auth select-auth --workflow #/workflows/workflow_callback --pro
 
 ## See also
 
-* [slack external-auth](slack_external-auth)	 - Adjust settings of external authentication providers
+* [slack external-auth](/tools/slack-cli/reference/commands/slack_external-auth/)	 - Adjust settings of external authentication providers
 
diff --git a/docs/reference/commands/slack_feedback.md b/docs/reference/commands/slack_feedback.md
index 55369202..1d96d491 100644
--- a/docs/reference/commands/slack_feedback.md
+++ b/docs/reference/commands/slack_feedback.md
@@ -46,5 +46,5 @@ $ slack feedback --name slack-cli  # Give feedback on the Slack CLI
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
 
diff --git a/docs/reference/commands/slack_function.md b/docs/reference/commands/slack_function.md
index 4edf70bc..26780afc 100644
--- a/docs/reference/commands/slack_function.md
+++ b/docs/reference/commands/slack_function.md
@@ -52,6 +52,6 @@ $ slack function distribute --info
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
-* [slack function access](slack_function_access)	 - Adjust who can access functions published from an app
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
+* [slack function access](/tools/slack-cli/reference/commands/slack_function_access/)	 - Adjust who can access functions published from an app
 
diff --git a/docs/reference/commands/slack_function_access.md b/docs/reference/commands/slack_function_access.md
index 0b7b443e..bfbd803c 100644
--- a/docs/reference/commands/slack_function_access.md
+++ b/docs/reference/commands/slack_function_access.md
@@ -67,5 +67,5 @@ $ slack function access --info
 
 ## See also
 
-* [slack function](slack_function)	 - Manage the functions of an app
+* [slack function](/tools/slack-cli/reference/commands/slack_function/)	 - Manage the functions of an app
 
diff --git a/docs/reference/commands/slack_init.md b/docs/reference/commands/slack_init.md
index 538dc36e..f1fa8a89 100644
--- a/docs/reference/commands/slack_init.md
+++ b/docs/reference/commands/slack_init.md
@@ -59,5 +59,5 @@ $ slack init  # Initialize a project
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
 
diff --git a/docs/reference/commands/slack_install.md b/docs/reference/commands/slack_install.md
index 2d63b971..1fefe6e2 100644
--- a/docs/reference/commands/slack_install.md
+++ b/docs/reference/commands/slack_install.md
@@ -49,5 +49,5 @@ $ slack app install --team T0123456 --environment local
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
 
diff --git a/docs/reference/commands/slack_list.md b/docs/reference/commands/slack_list.md
index 797c3f5f..3c95726e 100644
--- a/docs/reference/commands/slack_list.md
+++ b/docs/reference/commands/slack_list.md
@@ -39,5 +39,5 @@ $ slack auth list  # List all authorized accounts
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
 
diff --git a/docs/reference/commands/slack_login.md b/docs/reference/commands/slack_login.md
index 4d2180e9..15199803 100644
--- a/docs/reference/commands/slack_login.md
+++ b/docs/reference/commands/slack_login.md
@@ -52,5 +52,5 @@ $ slack auth login --token xoxp-...
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
 
diff --git a/docs/reference/commands/slack_logout.md b/docs/reference/commands/slack_logout.md
index de2a9b4d..d986836f 100644
--- a/docs/reference/commands/slack_logout.md
+++ b/docs/reference/commands/slack_logout.md
@@ -41,5 +41,5 @@ $ slack auth logout --all  # Log out of all team
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
 
diff --git a/docs/reference/commands/slack_manifest.md b/docs/reference/commands/slack_manifest.md
index 2bb583d6..51830f62 100644
--- a/docs/reference/commands/slack_manifest.md
+++ b/docs/reference/commands/slack_manifest.md
@@ -51,8 +51,8 @@ $ slack manifest validate
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
-* [slack manifest diff](slack_manifest_diff)	 - Show differences between the project manifest and app settings
-* [slack manifest info](slack_manifest_info)	 - Print the app manifest of a project or app
-* [slack manifest validate](slack_manifest_validate)	 - Validate the app manifest generated by a project
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
+* [slack manifest diff](/tools/slack-cli/reference/commands/slack_manifest_diff/)	 - Show differences between the project manifest and app settings
+* [slack manifest info](/tools/slack-cli/reference/commands/slack_manifest_info/)	 - Print the app manifest of a project or app
+* [slack manifest validate](/tools/slack-cli/reference/commands/slack_manifest_validate/)	 - Validate the app manifest generated by a project
 
diff --git a/docs/reference/commands/slack_manifest_diff.md b/docs/reference/commands/slack_manifest_diff.md
index ef86436e..93cfbe10 100644
--- a/docs/reference/commands/slack_manifest_diff.md
+++ b/docs/reference/commands/slack_manifest_diff.md
@@ -43,5 +43,5 @@ $ slack manifest diff --app A0123456789 --token xoxp-...
 
 ## See also
 
-* [slack manifest](slack_manifest)	 - Print the app manifest of a project or app
+* [slack manifest](/tools/slack-cli/reference/commands/slack_manifest/)	 - Print the app manifest of a project or app
 
diff --git a/docs/reference/commands/slack_manifest_info.md b/docs/reference/commands/slack_manifest_info.md
index 93364114..94e92ee2 100644
--- a/docs/reference/commands/slack_manifest_info.md
+++ b/docs/reference/commands/slack_manifest_info.md
@@ -52,5 +52,5 @@ $ slack manifest info --source remote
 
 ## See also
 
-* [slack manifest](slack_manifest)	 - Print the app manifest of a project or app
+* [slack manifest](/tools/slack-cli/reference/commands/slack_manifest/)	 - Print the app manifest of a project or app
 
diff --git a/docs/reference/commands/slack_manifest_validate.md b/docs/reference/commands/slack_manifest_validate.md
index 49ad078b..0bb4884f 100644
--- a/docs/reference/commands/slack_manifest_validate.md
+++ b/docs/reference/commands/slack_manifest_validate.md
@@ -40,5 +40,5 @@ $ slack manifest validate
 
 ## See also
 
-* [slack manifest](slack_manifest)	 - Print the app manifest of a project or app
+* [slack manifest](/tools/slack-cli/reference/commands/slack_manifest/)	 - Print the app manifest of a project or app
 
diff --git a/docs/reference/commands/slack_platform.md b/docs/reference/commands/slack_platform.md
index b40b788f..576d3268 100644
--- a/docs/reference/commands/slack_platform.md
+++ b/docs/reference/commands/slack_platform.md
@@ -41,8 +41,8 @@ $ slack activity -t             # Continuously poll for new activity logs
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
-* [slack platform activity](slack_platform_activity)	 - Display the app activity logs from the Slack Platform
-* [slack platform deploy](slack_platform_deploy)	 - Deploy the app to the Slack Platform
-* [slack platform run](slack_platform_run)	 - Start a local server to develop and run the app locally
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
+* [slack platform activity](/tools/slack-cli/reference/commands/slack_platform_activity/)	 - Display the app activity logs from the Slack Platform
+* [slack platform deploy](/tools/slack-cli/reference/commands/slack_platform_deploy/)	 - Deploy the app to the Slack Platform
+* [slack platform run](/tools/slack-cli/reference/commands/slack_platform_run/)	 - Start a local server to develop and run the app locally
 
diff --git a/docs/reference/commands/slack_platform_activity.md b/docs/reference/commands/slack_platform_activity.md
index 75facc44..91fd955c 100644
--- a/docs/reference/commands/slack_platform_activity.md
+++ b/docs/reference/commands/slack_platform_activity.md
@@ -57,5 +57,5 @@ $ slack platform activity -t  # Continuously poll for new activity logs
 
 ## See also
 
-* [slack platform](slack_platform)	 - Deploy and run apps on the Slack Platform
+* [slack platform](/tools/slack-cli/reference/commands/slack_platform/)	 - Deploy and run apps on the Slack Platform
 
diff --git a/docs/reference/commands/slack_platform_deploy.md b/docs/reference/commands/slack_platform_deploy.md
index e26ed90e..0023e2ab 100644
--- a/docs/reference/commands/slack_platform_deploy.md
+++ b/docs/reference/commands/slack_platform_deploy.md
@@ -44,5 +44,5 @@ $ slack platform deploy --team T0123456  # Deploy to a specific team
 
 ## See also
 
-* [slack platform](slack_platform)	 - Deploy and run apps on the Slack Platform
+* [slack platform](/tools/slack-cli/reference/commands/slack_platform/)	 - Deploy and run apps on the Slack Platform
 
diff --git a/docs/reference/commands/slack_platform_run.md b/docs/reference/commands/slack_platform_run.md
index 34677798..b51513b2 100644
--- a/docs/reference/commands/slack_platform_run.md
+++ b/docs/reference/commands/slack_platform_run.md
@@ -51,5 +51,5 @@ $ slack platform run --cleanup
 
 ## See also
 
-* [slack platform](slack_platform)	 - Deploy and run apps on the Slack Platform
+* [slack platform](/tools/slack-cli/reference/commands/slack_platform/)	 - Deploy and run apps on the Slack Platform
 
diff --git a/docs/reference/commands/slack_project.md b/docs/reference/commands/slack_project.md
index 9395a3d0..9dd789b1 100644
--- a/docs/reference/commands/slack_project.md
+++ b/docs/reference/commands/slack_project.md
@@ -52,8 +52,8 @@ $ slack project samples
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
-* [slack project create](slack_project_create)	 - Create a new Slack project
-* [slack project init](slack_project_init)	 - Initialize a project to work with the Slack CLI
-* [slack project samples](slack_project_samples)	 - List available sample apps
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
+* [slack project create](/tools/slack-cli/reference/commands/slack_project_create/)	 - Create a new Slack project
+* [slack project init](/tools/slack-cli/reference/commands/slack_project_init/)	 - Initialize a project to work with the Slack CLI
+* [slack project samples](/tools/slack-cli/reference/commands/slack_project_samples/)	 - List available sample apps
 
diff --git a/docs/reference/commands/slack_project_create.md b/docs/reference/commands/slack_project_create.md
index 7a37ad6b..74c69feb 100644
--- a/docs/reference/commands/slack_project_create.md
+++ b/docs/reference/commands/slack_project_create.md
@@ -64,5 +64,5 @@ $ slack create my-project -t slack-samples/bolt-js-starter-template --app A01234
 
 ## See also
 
-* [slack project](slack_project)	 - Create, manage, and doctor a project
+* [slack project](/tools/slack-cli/reference/commands/slack_project/)	 - Create, manage, and doctor a project
 
diff --git a/docs/reference/commands/slack_project_init.md b/docs/reference/commands/slack_project_init.md
index 63eb4b3e..36438e0f 100644
--- a/docs/reference/commands/slack_project_init.md
+++ b/docs/reference/commands/slack_project_init.md
@@ -59,5 +59,5 @@ $ slack init  # Initialize a project
 
 ## See also
 
-* [slack project](slack_project)	 - Create, manage, and doctor a project
+* [slack project](/tools/slack-cli/reference/commands/slack_project/)	 - Create, manage, and doctor a project
 
diff --git a/docs/reference/commands/slack_project_samples.md b/docs/reference/commands/slack_project_samples.md
index d8bf64f4..c103d992 100644
--- a/docs/reference/commands/slack_project_samples.md
+++ b/docs/reference/commands/slack_project_samples.md
@@ -43,5 +43,5 @@ $ slack samples my-project              # Select a sample app to create
 
 ## See also
 
-* [slack project](slack_project)	 - Create, manage, and doctor a project
+* [slack project](/tools/slack-cli/reference/commands/slack_project/)	 - Create, manage, and doctor a project
 
diff --git a/docs/reference/commands/slack_run.md b/docs/reference/commands/slack_run.md
index ccb59969..6112d4c7 100644
--- a/docs/reference/commands/slack_run.md
+++ b/docs/reference/commands/slack_run.md
@@ -51,5 +51,5 @@ $ slack platform run --cleanup
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
 
diff --git a/docs/reference/commands/slack_samples.md b/docs/reference/commands/slack_samples.md
index 9127467d..9a75bb15 100644
--- a/docs/reference/commands/slack_samples.md
+++ b/docs/reference/commands/slack_samples.md
@@ -43,5 +43,5 @@ $ slack samples my-project              # Select a sample app to create
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
 
diff --git a/docs/reference/commands/slack_sandbox.md b/docs/reference/commands/slack_sandbox.md
index e0eb4941..c6070682 100644
--- a/docs/reference/commands/slack_sandbox.md
+++ b/docs/reference/commands/slack_sandbox.md
@@ -40,8 +40,8 @@ slack sandbox <subcommand> [flags]
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
-* [slack sandbox create](slack_sandbox_create)	 - Create a developer sandbox
-* [slack sandbox delete](slack_sandbox_delete)	 - Delete a developer sandbox
-* [slack sandbox list](slack_sandbox_list)	 - List developer sandboxes
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
+* [slack sandbox create](/tools/slack-cli/reference/commands/slack_sandbox_create/)	 - Create a developer sandbox
+* [slack sandbox delete](/tools/slack-cli/reference/commands/slack_sandbox_delete/)	 - Delete a developer sandbox
+* [slack sandbox list](/tools/slack-cli/reference/commands/slack_sandbox_list/)	 - List developer sandboxes
 
diff --git a/docs/reference/commands/slack_sandbox_create.md b/docs/reference/commands/slack_sandbox_create.md
index 21ae046c..bb2a1285 100644
--- a/docs/reference/commands/slack_sandbox_create.md
+++ b/docs/reference/commands/slack_sandbox_create.md
@@ -56,5 +56,5 @@ $ slack sandbox create --name test-box --password mypass --domain test-box --arc
 
 ## See also
 
-* [slack sandbox](slack_sandbox)	 - Manage developer sandboxes
+* [slack sandbox](/tools/slack-cli/reference/commands/slack_sandbox/)	 - Manage developer sandboxes
 
diff --git a/docs/reference/commands/slack_sandbox_delete.md b/docs/reference/commands/slack_sandbox_delete.md
index e93f7c20..b52ab62b 100644
--- a/docs/reference/commands/slack_sandbox_delete.md
+++ b/docs/reference/commands/slack_sandbox_delete.md
@@ -41,5 +41,5 @@ $ slack sandbox delete --sandbox-id E0123456
 
 ## See also
 
-* [slack sandbox](slack_sandbox)	 - Manage developer sandboxes
+* [slack sandbox](/tools/slack-cli/reference/commands/slack_sandbox/)	 - Manage developer sandboxes
 
diff --git a/docs/reference/commands/slack_sandbox_list.md b/docs/reference/commands/slack_sandbox_list.md
index 870297e4..5bd8b3a0 100644
--- a/docs/reference/commands/slack_sandbox_list.md
+++ b/docs/reference/commands/slack_sandbox_list.md
@@ -44,5 +44,5 @@ $ slack sandbox list --status active  # List active sandboxes only
 
 ## See also
 
-* [slack sandbox](slack_sandbox)	 - Manage developer sandboxes
+* [slack sandbox](/tools/slack-cli/reference/commands/slack_sandbox/)	 - Manage developer sandboxes
 
diff --git a/docs/reference/commands/slack_trigger.md b/docs/reference/commands/slack_trigger.md
index e8706b22..bb643500 100644
--- a/docs/reference/commands/slack_trigger.md
+++ b/docs/reference/commands/slack_trigger.md
@@ -53,11 +53,11 @@ $ slack trigger update --trigger-id Ft01234ABCD
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
-* [slack trigger access](slack_trigger_access)	 - Manage who can use your triggers
-* [slack trigger create](slack_trigger_create)	 - Create a trigger for a workflow
-* [slack trigger delete](slack_trigger_delete)	 - Delete an existing trigger
-* [slack trigger info](slack_trigger_info)	 - Get details for a specific trigger
-* [slack trigger list](slack_trigger_list)	 - List details of existing triggers
-* [slack trigger update](slack_trigger_update)	 - Updates an existing trigger
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
+* [slack trigger access](/tools/slack-cli/reference/commands/slack_trigger_access/)	 - Manage who can use your triggers
+* [slack trigger create](/tools/slack-cli/reference/commands/slack_trigger_create/)	 - Create a trigger for a workflow
+* [slack trigger delete](/tools/slack-cli/reference/commands/slack_trigger_delete/)	 - Delete an existing trigger
+* [slack trigger info](/tools/slack-cli/reference/commands/slack_trigger_info/)	 - Get details for a specific trigger
+* [slack trigger list](/tools/slack-cli/reference/commands/slack_trigger_list/)	 - List details of existing triggers
+* [slack trigger update](/tools/slack-cli/reference/commands/slack_trigger_update/)	 - Updates an existing trigger
 
diff --git a/docs/reference/commands/slack_trigger_access.md b/docs/reference/commands/slack_trigger_access.md
index 80bb4cef..d9c78633 100644
--- a/docs/reference/commands/slack_trigger_access.md
+++ b/docs/reference/commands/slack_trigger_access.md
@@ -62,5 +62,5 @@ $ slack trigger access --trigger-id Ft01234ABCD --revoke \
 
 ## See also
 
-* [slack trigger](slack_trigger)	 - List details of existing triggers
+* [slack trigger](/tools/slack-cli/reference/commands/slack_trigger/)	 - List details of existing triggers
 
diff --git a/docs/reference/commands/slack_trigger_create.md b/docs/reference/commands/slack_trigger_create.md
index 79c6b413..a081e556 100644
--- a/docs/reference/commands/slack_trigger_create.md
+++ b/docs/reference/commands/slack_trigger_create.md
@@ -64,5 +64,5 @@ $ slack trigger create --workflow "#/workflows/my_workflow"
 
 ## See also
 
-* [slack trigger](slack_trigger)	 - List details of existing triggers
+* [slack trigger](/tools/slack-cli/reference/commands/slack_trigger/)	 - List details of existing triggers
 
diff --git a/docs/reference/commands/slack_trigger_delete.md b/docs/reference/commands/slack_trigger_delete.md
index 7908f989..fa7e0c57 100644
--- a/docs/reference/commands/slack_trigger_delete.md
+++ b/docs/reference/commands/slack_trigger_delete.md
@@ -44,5 +44,5 @@ $ slack trigger delete --trigger-id Ft01234ABCD --app A0123456
 
 ## See also
 
-* [slack trigger](slack_trigger)	 - List details of existing triggers
+* [slack trigger](/tools/slack-cli/reference/commands/slack_trigger/)	 - List details of existing triggers
 
diff --git a/docs/reference/commands/slack_trigger_info.md b/docs/reference/commands/slack_trigger_info.md
index 94c56e67..d7bea949 100644
--- a/docs/reference/commands/slack_trigger_info.md
+++ b/docs/reference/commands/slack_trigger_info.md
@@ -44,5 +44,5 @@ $ slack trigger info --trigger-id Ft01234ABCD --app A0123456
 
 ## See also
 
-* [slack trigger](slack_trigger)	 - List details of existing triggers
+* [slack trigger](/tools/slack-cli/reference/commands/slack_trigger/)	 - List details of existing triggers
 
diff --git a/docs/reference/commands/slack_trigger_list.md b/docs/reference/commands/slack_trigger_list.md
index 7c68132c..169951e6 100644
--- a/docs/reference/commands/slack_trigger_list.md
+++ b/docs/reference/commands/slack_trigger_list.md
@@ -45,5 +45,5 @@ $ slack trigger list --team T0123456 --app local
 
 ## See also
 
-* [slack trigger](slack_trigger)	 - List details of existing triggers
+* [slack trigger](/tools/slack-cli/reference/commands/slack_trigger/)	 - List details of existing triggers
 
diff --git a/docs/reference/commands/slack_trigger_update.md b/docs/reference/commands/slack_trigger_update.md
index 5dba6791..46470ed2 100644
--- a/docs/reference/commands/slack_trigger_update.md
+++ b/docs/reference/commands/slack_trigger_update.md
@@ -61,5 +61,5 @@ $ slack trigger update --trigger-id Ft01234ABCD \
 
 ## See also
 
-* [slack trigger](slack_trigger)	 - List details of existing triggers
+* [slack trigger](/tools/slack-cli/reference/commands/slack_trigger/)	 - List details of existing triggers
 
diff --git a/docs/reference/commands/slack_uninstall.md b/docs/reference/commands/slack_uninstall.md
index 2bfe407e..5e28e24c 100644
--- a/docs/reference/commands/slack_uninstall.md
+++ b/docs/reference/commands/slack_uninstall.md
@@ -39,5 +39,5 @@ $ slack app uninstall  # Uninstall an app from a team
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
 
diff --git a/docs/reference/commands/slack_upgrade.md b/docs/reference/commands/slack_upgrade.md
index 7f1d8753..e49c0d17 100644
--- a/docs/reference/commands/slack_upgrade.md
+++ b/docs/reference/commands/slack_upgrade.md
@@ -48,5 +48,5 @@ $ slack upgrade  # Check for any available updates
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool
 
diff --git a/docs/reference/commands/slack_version.md b/docs/reference/commands/slack_version.md
index fb889698..25704d0d 100644
--- a/docs/reference/commands/slack_version.md
+++ b/docs/reference/commands/slack_version.md
@@ -61,5 +61,5 @@ $ slack --version --skip-update  # Print version and skip update check
 
 ## See also
 
-* [slack](slack)	 - Slack command-line tool
+* [slack](/tools/slack-cli/reference/commands/slack/)	 - Slack command-line tool