improve command group summaries

account.go

···
 
 var cmdAccount = &cli.Command{
 	Name:  "account",
-	Usage: "sub-commands for auth and account management",
+	Usage: "commands for auth session and account management",
 	Flags: []cli.Flag{},
 	Commands: []*cli.Command{
 		&cli.Command{

account_migrate.go

···
 
 var cmdAccountMigrate = &cli.Command{
 	Name:  "migrate",
-	Usage: "move account to a new PDS. requires full auth.",
+	Usage: "move account to a new PDS. requires full auth (not app password)",
 	Flags: []cli.Flag{
 		&cli.StringFlag{
 			Name:     "pds-host",

account_plc.go

···
 
 var cmdAccountPlc = &cli.Command{
 	Name:  "plc",
-	Usage: "sub-commands for managing PLC DID via PDS host",
+	Usage: "commands for managing PLC identity (DID) via PDS host",
 	Flags: []cli.Flag{
 		&cli.StringFlag{
 			Name:    "plc-host",

blob.go

···
 
 var cmdBlob = &cli.Command{
 	Name:  "blob",
-	Usage: "sub-commands for blobs",
+	Usage: "commands for media files (blobs)",
 	Flags: []cli.Flag{},
 	Commands: []*cli.Command{
 		&cli.Command{
 			Name:      "export",
-			Usage:     "download all blobs for given account",
+			Usage:     "download all public blobs for indicated account",
 			ArgsUsage: `<at-identifier>`,
 			Flags: []cli.Flag{
 				&cli.StringFlag{
···
 		&cli.Command{
 			Name:      "ls",
 			Aliases:   []string{"list"},
-			Usage:     "list all blobs for account",
+			Usage:     "list all public blobs for indicated account",
 			ArgsUsage: `<at-identifier>`,
 			Flags:     []cli.Flag{},
 			Action:    runBlobList,
···
 		},
 		&cli.Command{
 			Name:      "upload",
-			Usage:     "upload a file",
+			Usage:     "upload a file (blob) to PDS",
 			ArgsUsage: `<file>`,
 			Flags:     []cli.Flag{},
 			Action:    runBlobUpload,

bsky.go

···
 
 var cmdBsky = &cli.Command{
 	Name:  "bsky",
-	Usage: "sub-commands for bsky app",
+	Usage: "commands for bluesky social app (eg, posting)",
 	Flags: []cli.Flag{},
 	Commands: []*cli.Command{
 		&cli.Command{
 			Name:      "post",
-			Usage:     "create a post",
+			Usage:     "create a bluesky post",
 			ArgsUsage: `<text>`,
 			Action:    runBskyPost,
 		},

bsky_prefs.go

···
 
 var cmdBskyPrefs = &cli.Command{
 	Name:  "prefs",
-	Usage: "sub-commands for preferences",
+	Usage: "commands for app preferences",
 	Flags: []cli.Flag{},
 	Commands: []*cli.Command{
 		&cli.Command{

key.go

···
 
 var cmdKey = &cli.Command{
 	Name:  "key",
-	Usage: "sub-commands for cryptographic keys",
+	Usage: "commands for managing cryptographic keys",
 	Commands: []*cli.Command{
 		&cli.Command{
 			Name:  "generate",
-			Usage: "outputs a new secret key",
+			Usage: "create a new secret key",
 			Flags: []cli.Flag{
 				&cli.StringFlag{
 					Name:    "type",

lexicon.go

···
 
 var cmdLex = &cli.Command{
 	Name:  "lex",
-	Usage: "sub-commands for Lexicons",
+	Usage: "commands for Lexicon schemas",
 	Flags: []cli.Flag{},
 	Commands: []*cli.Command{
 		&cli.Command{

pds.go

···
 
 var cmdPds = &cli.Command{
 	Name:  "pds",
-	Usage: "sub-commands for pds hosts",
+	Usage: "commands for inspecting and administering PDS hosts",
 	Flags: []cli.Flag{},
 	Commands: []*cli.Command{
 		&cli.Command{

plc.go

···
 
 var cmdPLC = &cli.Command{
 	Name:  "plc",
-	Usage: "sub-commands for DID PLCs",
+	Usage: "commands for PLC identities (DIDs) and directory interactions (see also 'account plc')",
 	Flags: []cli.Flag{
 		&cli.StringFlag{
 			Name:    "plc-host",

record.go

···
 
 var cmdRecord = &cli.Command{
 	Name:  "record",
-	Usage: "sub-commands for repo records",
+	Usage: "commands for public repo records",
 	Flags: []cli.Flag{},
 	Commands: []*cli.Command{
 		cmdRecordGet,

relay.go

···
 
 var cmdRelay = &cli.Command{
 	Name:  "relay",
-	Usage: "sub-commands for relays",
+	Usage: "commands for querying and administering relays",
 	Flags: []cli.Flag{
 		&cli.StringFlag{
 			Name:    "relay-host",
···
 	Commands: []*cli.Command{
 		&cli.Command{
 			Name:  "account",
-			Usage: "sub-commands for accounts/repos on relay",
+			Usage: "commands for accounts/repos on relay",
 			Commands: []*cli.Command{
 				&cli.Command{
 					Name:    "list",
···
 		},
 		&cli.Command{
 			Name:  "host",
-			Usage: "sub-commands for upstream hosts (eg, PDS)",
+			Usage: "commands for upstream hosts (eg, PDS)",
 			Commands: []*cli.Command{
 				&cli.Command{
 					Name:      "request-crawl",

relay_admin.go

···
 
 var cmdRelayAdmin = &cli.Command{
 	Name:  "admin",
-	Usage: "sub-comands for relay administration",
+	Usage: "comands for relay administration",
 	Flags: []cli.Flag{
 		&cli.StringFlag{
 			Name:    "admin-password",
···
 	Commands: []*cli.Command{
 		&cli.Command{
 			Name:  "account",
-			Usage: "sub-commands for managing accounts",
+			Usage: "commands for managing accounts",
 			Commands: []*cli.Command{
 				&cli.Command{
 					Name:  "takedown",
···
 		},
 		&cli.Command{
 			Name:  "host",
-			Usage: "sub-commands for upstream hosts (eg, PDS)",
+			Usage: "commands for upstream hosts (eg, PDS)",
 			Commands: []*cli.Command{
 				&cli.Command{
 					Name:      "add",
···
 		},
 		&cli.Command{
 			Name:  "domain",
-			Usage: "sub-commands for domain-level config",
+			Usage: "commands for domain-level config",
 			Commands: []*cli.Command{
 				&cli.Command{
 					Name:      "ban",
···
 		},
 		&cli.Command{
 			Name:  "consumer",
-			Usage: "sub-commands for consumers",
+			Usage: "commands for consumers",
 			Commands: []*cli.Command{
 				&cli.Command{
 					Name:    "list",

repo.go

···
 
 var cmdRepo = &cli.Command{
 	Name:  "repo",
-	Usage: "sub-commands for repositories",
+	Usage: "commands for public atproto data repositories",
 	Flags: []cli.Flag{},
 	Commands: []*cli.Command{
 		&cli.Command{

syntax.go

···
 
 var cmdSyntax = &cli.Command{
 	Name:  "syntax",
-	Usage: "sub-commands for string syntax helpers",
+	Usage: "commands for parsing identifier strings",
 	Commands: []*cli.Command{
 		&cli.Command{
 			Name:  "tid",
-			Usage: "sub-commands for TIDs",
+			Usage: "commands for TIDs",
 			Commands: []*cli.Command{
 				&cli.Command{
 					Name:      "check",
···
 		},
 		&cli.Command{
 			Name:  "handle",
-			Usage: "sub-commands for handle syntax",
+			Usage: "commands for handle syntax",
 			Commands: []*cli.Command{
 				&cli.Command{
 					Name:      "check",
···
 		},
 		&cli.Command{
 			Name:  "did",
-			Usage: "sub-commands for DID syntax",
+			Usage: "commands for DID syntax",
 			Commands: []*cli.Command{
 				&cli.Command{
 					Name:      "check",
···
 		},
 		&cli.Command{
 			Name:  "cid",
-			Usage: "sub-commands for CID syntax",
+			Usage: "commands for CID syntax",
 			Commands: []*cli.Command{
 				&cli.Command{
 					Name:      "check",
···
 		},
 		&cli.Command{
 			Name:  "rkey",
-			Usage: "sub-commands for record key syntax",
+			Usage: "commands for record key syntax",
 			Commands: []*cli.Command{
 				&cli.Command{
 					Name:      "check",
···
 		},
 		&cli.Command{
 			Name:  "nsid",
-			Usage: "sub-commands for NSID syntax",
+			Usage: "commands for NSID syntax",
 			Commands: []*cli.Command{
 				&cli.Command{
 					Name:      "check",
···
 		},
 		&cli.Command{
 			Name:  "at-uri",
-			Usage: "sub-commands for AT-URI syntax",
+			Usage: "commands for AT-URI syntax",
 			Commands: []*cli.Command{
 				&cli.Command{
 					Name:      "check",
···
 		},
 		&cli.Command{
 			Name:  "datetime",
-			Usage: "sub-commands for datetimes",
+			Usage: "commands for datetimes",
 			Commands: []*cli.Command{
 				&cli.Command{
 					Name:      "check",
···
 		},
 		&cli.Command{
 			Name:  "language",
-			Usage: "sub-commands for language code syntax",
+			Usage: "commands for language code syntax",
 			Commands: []*cli.Command{
 				&cli.Command{
 					Name:      "check",