diff --git a/docs/cli/commands/doctor.md b/docs/cli/commands/doctor.md
new file mode 100644
index 000000000..aaa5922b6
--- /dev/null
+++ b/docs/cli/commands/doctor.md
@@ -0,0 +1,19 @@
+---
+title: CLI Command - cap doctor
+description: Capacitor CLI - cap doctor
+contributors:
+  - shouzhi
+sidebar_label: doctor
+---
+
+# Capacitor CLI - cap doctor
+
+Checks the current setup for common errors.
+
+```bash
+npx cap doctor [<platform>]
+```
+
+<strong>Inputs:</strong>
+
+- `platform` (optional): `android`, `ios`
diff --git a/docs/cli/commands/migrate.md b/docs/cli/commands/migrate.md
new file mode 100644
index 000000000..fff281465
--- /dev/null
+++ b/docs/cli/commands/migrate.md
@@ -0,0 +1,21 @@
+---
+title: CLI Command - cap migrate
+description: Capacitor CLI - cap migrate
+contributors:
+  - shouzhi
+sidebar_label: migrate
+---
+
+# Capacitor CLI - cap migrate
+
+Migrate your current Capacitor app to the latest major version of Capacitor.
+
+```bash
+npx cap migrate [options]
+```
+
+<strong>Options:</strong>
+
+- `--noprompt`: do not prompt for confirmation
+- `--packagemanager <packageManager>`: The package manager to use for dependency installs (`npm`, `pnpm`, `yarn`)
+- `-h, --help`: display help for command
diff --git a/docs/cli/index.md b/docs/cli/index.md
index 04e75b794..c3f61e335 100644
--- a/docs/cli/index.md
+++ b/docs/cli/index.md
@@ -29,10 +29,10 @@ View all available CLI commands and options.
 - [`add`](/cli/commands/add.md)
 - [`build`](/cli/commands/build.md)
 - [`copy`](/cli/commands/copy.md)
-- `doctor`
+- [`doctor`](/cli/commands/doctor.md)
 - [`init`](/cli/commands/init.md)
 - [`ls`](/cli/commands/ls.md)
-- `migrate`
+- [`migrate`](/cli/commands/migrate.md)
 - [`open`](/cli/commands/open.md)
 - [`run`](/cli/commands/run.md)
 - [`sync`](/cli/commands/sync.md)