diff --git a/providers/slack/config/config.go b/providers/slack/config/config.go
index e44111e570..43d6903d3c 100644
--- a/providers/slack/config/config.go
+++ b/providers/slack/config/config.go
@@ -16,9 +16,15 @@ var Config = plugin.Provider{
 	ConnectionTypes: []string{provider.ConnectionType},
 	Connectors: []plugin.Connector{
 		{
-			Name:      "slack",
-			Use:       "slack",
-			Short:     "a Slack team",
+			Name:  "slack",
+			Use:   "slack",
+			Short: "a Slack team",
+			Long: `Use the slack provider to query resources in a Slack team.
+
+Examples:
+  cnquery shell slack --token <api-token>
+  cnspec scan slack --team-id <team-id> --token <api-token>
+`,
 			MinArgs:   0,
 			MaxArgs:   0,
 			Discovery: []string{},
@@ -27,13 +33,13 @@ var Config = plugin.Provider{
 					Long:    "token",
 					Type:    plugin.FlagType_String,
 					Default: "",
-					Desc:    "Slack API token",
+					Desc:    "Slack API token (To learn more, read https://mondoo.com/docs/cnspec/saas/slack/)",
 				},
 				{
 					Long:    "team-id",
 					Type:    plugin.FlagType_String,
 					Default: "",
-					Desc:    "Team ID (required for org token)",
+					Desc:    "Team ID (required if the token is an org token)",
 				},
 			},
 		},