♻️ Align cmd short, long, and confirmation

cmd/abuseReport/insert.go

@@ -20,9 +20,9 @@ import (
 
 const (
 	insertTool    = "abuseReport-insert"
-	insertConfirm = "Report abuse for %s %s"
-	insertShort   = "Insert an abuse report"
-	insertLong    = "Insert an abuse report. Use this tool to report abusive content on YouTube such as spam, harassment, or violent content."
+	insertConfirm = "Create abuse report for %s %s"
+	insertShort   = "Create an abuse report"
+	insertLong    = "Create an abuse report. Use this tool to report abusive content on YouTube such as spam, harassment, or violent content."
 	insertExample = `# Report a video as spam
 yutu abuseReport insert --abuseTypes spam --subjectId VIDEO_ID --subjectTypeId video --description "This video is spam"
 # Report a comment as harassment

cmd/activity/activity.go

@@ -9,8 +9,8 @@ import (
 )
 
 const (
-	short    = "Manage activities on YouTube"
-	long     = "Manage activities on YouTube. Use this tool to list channel activities."
+	short    = "Manage YouTube activities"
+	long     = "Manage YouTube activities. Use this tool to list channel activities."
 	ciUsage  = "ID of the channel"
 	forUsage = "home|mine"
 	paUsage  = "Filter on activities published after this date"

cmd/caption/insert.go

@@ -20,9 +20,9 @@ import (
 
 const (
 	insertTool    = "caption-insert"
-	insertConfirm = "Upload caption for video: %s"
-	insertShort   = "Insert a caption"
-	insertLong    = "Insert a caption. Use this tool to insert a caption to a video."
+	insertConfirm = "Upload caption: %s"
+	insertShort   = "Upload a caption"
+	insertLong    = "Upload a caption. Use this tool to upload a caption to a video."
 	insertExample = `# Insert a caption to a video
 yutu caption insert --file subtitle.srt --videoId dQw4w9WgXcQ
 # Insert a caption with language and name

cmd/caption/update.go

@@ -20,9 +20,9 @@ import (
 
 const (
 	updateTool    = "caption-update"
-	updateConfirm = "Update caption for video: %s"
-	updateShort   = "Update a video caption"
-	updateLong    = "Update a video caption. Use this tool to update a video caption."
+	updateConfirm = "Update caption: %s"
+	updateShort   = "Update a caption"
+	updateLong    = "Update a caption. Use this tool to update a caption."
 	updateExample = `# Publish a draft caption
 yutu caption update --videoId dQw4w9WgXcQ --isDraft=false
 # Update caption language and name

cmd/channel/list.go

@@ -20,8 +20,8 @@ import (
 const (
 	listTool     = "channel-list"
 	listIdsUsage = "Return the channels with the specified Ids"
-	listShort    = "List channel information"
-	listLong     = "List channel information. Use this tool to list channel information."
+	listShort    = "List channels"
+	listLong     = "List channels. Use this tool to list channels."
 	listExample  = `# List my channel info
 yutu channel list --for mine
 # List channel by handle

cmd/channel/update.go

@@ -23,8 +23,8 @@ const (
 	updateTool    = "channel-update"
 	updateIdUsage = "ID of the channel to update"
 	updateConfirm = "Update channel: %s"
-	updateShort   = "Update channel information"
-	updateLong    = "Update channel information. Use this tool to update channel information."
+	updateShort   = "Update a channel"
+	updateLong    = "Update a channel. Use this tool to update a channel."
 	updateExample = `# Update channel description
 yutu channel update --id UC_x5XG1OV2P6uZZ5FSM9Ttw --description 'New description'
 # Update channel title and country

cmd/channelBanner/insert.go

@@ -20,9 +20,9 @@ import (
 
 const (
 	insertTool    = "channelBanner-insert"
-	insertConfirm = "Insert channel banner: %s"
-	insertShort   = "Insert a channel banner"
-	insertLong    = "Insert a channel banner. Use this tool to upload a channel banner."
+	insertConfirm = "Upload channel banner: %s"
+	insertShort   = "Upload a channel banner"
+	insertLong    = "Upload a channel banner. Use this tool to upload a channel banner."
 	insertExample = `# Upload a channel banner
 yutu channelBanner insert --channelId UC_x5XG1OV2P6uZZ5FSM9Ttw --file banner.jpg
 # Upload a channel banner with JSON output

cmd/comment/insert.go

@@ -21,7 +21,7 @@ import (
 const (
 	insertTool     = "comment-insert"
 	insertPidUsage = "ID of the parent comment"
-	insertConfirm  = "Insert comment on parent: %s"
+	insertConfirm  = "Create comment on parent: %s"
 	insertShort    = "Create a comment"
 	insertLong     = "Create a comment. Use this tool to create a comment on a video."
 	insertExample  = `# Reply to a comment

cmd/comment/update.go

@@ -23,8 +23,8 @@ const (
 	updateTool    = "comment-update"
 	updateIdUsage = "ID of the comment"
 	updateConfirm = "Update comment: %s"
-	updateShort   = "Update a comment on a video"
-	updateLong    = "Update a comment on a video. Use this tool to update a comment on a video."
+	updateShort   = "Update a comment"
+	updateLong    = "Update a comment. Use this tool to update a comment."
 	updateExample = `# Update comment text
 yutu comment update --id abc123 --textOriginal 'Updated comment'
 # Like a comment

cmd/commentThread/insert.go

@@ -21,9 +21,9 @@ import (
 const (
 	insertTool     = "commentThread-insert"
 	insertVidUsage = "ID of the video"
-	insertConfirm  = "Insert comment thread on video: %s"
-	insertShort    = "Insert a new comment thread"
-	insertLong     = "Insert a new comment thread. Use this tool to insert a new comment thread."
+	insertConfirm  = "Create comment thread on video: %s"
+	insertShort    = "Create a comment thread"
+	insertLong     = "Create a comment thread. Use this tool to create a comment thread."
 	insertExample  = `# Post a comment on a video
 yutu commentThread insert --channelId UC_x5X --videoId dQw4w9WgXcQ --authorChannelId UA_x5X --textOriginal 'Great video!'
 # Post a comment with JSON output

cmd/liveBroadcast/insert.go

@@ -21,8 +21,8 @@ import (
 const (
 	insertTool    = "liveBroadcast-insert"
 	insertConfirm = "Create live broadcast: %s"
-	insertShort   = "Insert a live broadcast"
-	insertLong    = "Insert a live broadcast. Use this tool to create a new live broadcast for the authenticated user."
+	insertShort   = "Create a live broadcast"
+	insertLong    = "Create a live broadcast. Use this tool to create a live broadcast for the authenticated user."
 	insertExample = `# Create a public live broadcast
 yutu liveBroadcast insert --title "My Broadcast" --privacyStatus public --scheduledStartTime 2026-01-01T00:00:00Z
 # Create a private broadcast with description

cmd/liveChatBan/insert.go

@@ -21,8 +21,8 @@ import (
 const (
 	insertTool    = "liveChatBan-insert"
 	insertConfirm = "Ban user %s in live chat %s"
-	insertShort   = "Insert a live chat ban"
-	insertLong    = "Insert a live chat ban. Use this tool to ban a user from a live chat."
+	insertShort   = "Create a live chat ban"
+	insertLong    = "Create a live chat ban. Use this tool to ban a user from a live chat."
 	insertExample = `# Ban a user permanently
 yutu liveChatBan insert --liveChatId abc123 --bannedUserChannelId UC_xyz --banType permanent
 # Ban a user temporarily for 5 minutes

cmd/liveChatModerator/insert.go

@@ -21,8 +21,8 @@ import (
 const (
 	insertTool    = "liveChatModerator-insert"
 	insertConfirm = "Add moderator %s to live chat %s"
-	insertShort   = "Insert a live chat moderator"
-	insertLong    = "Insert a live chat moderator. Use this tool to add a moderator to a live chat."
+	insertShort   = "Add a live chat moderator"
+	insertLong    = "Add a live chat moderator. Use this tool to add a moderator to a live chat."
 	insertExample = `# Add a moderator to a live chat
 yutu liveChatModerator insert --liveChatId abc123 --moderatorChannelId UC_xyz`
 )

cmd/liveStream/insert.go

@@ -21,8 +21,8 @@ import (
 const (
 	insertTool    = "liveStream-insert"
 	insertConfirm = "Create live stream: %s"
-	insertShort   = "Insert a live stream"
-	insertLong    = "Insert a live stream. Use this tool to create a new live stream for the authenticated user."
+	insertShort   = "Create a live stream"
+	insertLong    = "Create a live stream. Use this tool to create a live stream."
 	insertExample = `# Create a live stream with RTMP at 1080p
 yutu liveStream insert --title "My Stream" --ingestionType rtmp --resolution 1080p --frameRate 60fps
 # Create a live stream with description

cmd/membershipsLevel/list.go

@@ -19,8 +19,8 @@ import (
 
 const (
 	listTool    = "membershipsLevel-list"
-	listShort   = "List memberships levels"
-	listLong    = "List memberships levels. Use this tool to list information about channel membership levels."
+	listShort   = "List membership levels"
+	listLong    = "List membership levels. Use this tool to list membership levels."
 	listExample = `# List membership levels in JSON format
 yutu membershipsLevel list --output json`
 )

cmd/membershipsLevel/membershipsLevel.go

@@ -9,8 +9,8 @@ import (
 )
 
 const (
-	short = "Manage YouTube memberships levels"
-	long  = "Manage YouTube memberships levels. Use this tool to list information about channel membership levels."
+	short = "Manage YouTube membership levels"
+	long  = "Manage YouTube membership levels. Use this tool to list membership levels."
 )
 
 var (

cmd/playlist/insert.go

@@ -21,9 +21,9 @@ import (
 const (
 	insertTool     = "playlist-insert"
 	insertCidUsage = "Channel id of the playlist"
-	insertConfirm  = "Insert playlist: %s"
-	insertShort    = "Create a new playlist"
-	insertLong     = "Create a new playlist. Use this tool to create a new playlist."
+	insertConfirm  = "Create playlist: %s"
+	insertShort    = "Create a playlist"
+	insertLong     = "Create a playlist. Use this tool to create a playlist."
 	insertExample  = `# Create a public playlist
 yutu playlist insert --title 'My Playlist' --channelId UC_x5XG1OV2P6uZZ5FSM9Ttw --privacy public
 # Create a private playlist with description

cmd/playlist/list.go

@@ -21,8 +21,8 @@ const (
 	listTool     = "playlist-list"
 	listIdsUsage = "Return the playlists with the given Ids for Stubby or Apiary"
 	listCidUsage = "Return the playlists owned by the specified channel id"
-	listShort    = "List playlist information"
-	listLong     = "List playlist information. Use this tool to list playlist information."
+	listShort    = "List playlists"
+	listLong     = "List playlists. Use this tool to list playlists."
 	listExample  = `# List my playlists
 yutu playlist list --mine
 # List playlists by channel ID with limit

cmd/playlistImage/insert.go

@@ -20,9 +20,9 @@ import (
 
 const (
 	insertTool    = "playlistImage-insert"
-	insertConfirm = "Insert playlist image: %s"
-	insertShort   = "Insert a playlist image"
-	insertLong    = "Insert a playlist image. Use this tool to insert a YouTube playlist image for a given playlist ID."
+	insertConfirm = "Upload playlist image: %s"
+	insertShort   = "Upload a playlist image"
+	insertLong    = "Upload a playlist image. Use this tool to upload a playlist image."
 	insertExample = `# Insert a playlist cover image
 yutu playlistImage insert --file cover.jpg --playlistId PLxxx
 # Insert a hero image

cmd/playlistImage/update.go

@@ -20,7 +20,7 @@ import (
 
 const (
 	updateTool    = "playlistImage-update"
-	updateConfirm = "Update playlist image for playlist: %s"
+	updateConfirm = "Update playlist image: %s"
 	updateShort   = "Update a playlist image"
 	updateLong    = "Update a playlist image. Use this tool to update a playlist image."
 	updateExample = `# Update a playlist image

cmd/playlistItem/delete.go

@@ -22,8 +22,8 @@ const (
 	deleteTool     = "playlistItem-delete"
 	deleteIdsUsage = "IDs of the playlist items to delete"
 	deleteConfirm  = "Delete playlist item(s): %s"
-	deleteShort    = "Delete items from a playlist"
-	deleteLong     = "Delete items from a playlist. Use this tool to delete items from a playlist by IDs."
+	deleteShort    = "Delete playlist items"
+	deleteLong     = "Delete playlist items. Use this tool to delete playlist items by IDs."
 	deleteExample  = `# Delete a playlist item by ID
 yutu playlistItem delete --ids abc123
 # Delete multiple playlist items

cmd/playlistItem/insert.go

@@ -21,9 +21,9 @@ import (
 const (
 	insertTool     = "playlistItem-insert"
 	insertPidUsage = "The id that YouTube uses to uniquely identify the playlist that the item is in"
-	insertConfirm  = "Insert playlist item to playlist: %s"
-	insertShort    = "Insert a playlist item into a playlist"
-	insertLong     = "Insert a playlist item into a playlist. Use this tool to insert a playlist item into a playlist."
+	insertConfirm  = "Add playlist item to playlist: %s"
+	insertShort    = "Add a playlist item"
+	insertLong     = "Add a playlist item. Use this tool to add a playlist item to a playlist."
 	insertExample  = `# Add a video to a playlist
 yutu playlistItem insert --kind video --playlistId PLxxx --channelId UC_x5X --kVideoId dQw4w9WgXcQ
 # Add a video to a playlist with privacy setting

cmd/subscription/insert.go

@@ -21,9 +21,9 @@ import (
 const (
 	insertTool     = "subscription-insert"
 	insertCidUsage = "ID of the channel to be subscribed"
-	insertConfirm  = "Insert subscription to channel: %s"
-	insertShort    = "Insert a new subscription"
-	insertLong     = "Insert a new subscription. Use this tool to insert a new subscription."
+	insertConfirm  = "Create subscription to channel: %s"
+	insertShort    = "Create a subscription"
+	insertLong     = "Create a subscription. Use this tool to create a subscription."
 	insertExample  = `# Subscribe to a channel
 yutu subscription insert --subscriberChannelId UC_abc --channelId UC_x5XG1OV2P6uZZ5FSM9Ttw
 # Subscribe with a title

cmd/subscription/list.go

@@ -21,8 +21,8 @@ const (
 	listTool     = "subscription-list"
 	listIdsUsage = "Return the subscriptions with the given ids for Stubby or Apiary"
 	listCidUsage = "Return the subscriptions of the given channel owner"
-	listShort    = "List subscription information"
-	listLong     = "List subscription information. Use this tool to list subscription information."
+	listShort    = "List subscriptions"
+	listLong     = "List subscriptions. Use this tool to list subscriptions."
 	listExample  = `# List my subscriptions
 yutu subscription list --for mine
 # List subscriptions by channel ID with limit

cmd/thirdPartyLink/delete.go

@@ -19,9 +19,9 @@ import (
 
 const (
 	deleteTool    = "thirdPartyLink-delete"
-	deleteConfirm = "Delete third-party link: %s"
-	deleteShort   = "Delete a third-party link"
-	deleteLong    = "Delete a third-party link. Use this tool to delete a link between a YouTube channel and a third-party service."
+	deleteConfirm = "Delete third-party link(s): %s"
+	deleteShort   = "Delete third-party links"
+	deleteLong    = "Delete third-party links. Use this tool to delete third-party links."
 	deleteExample = `# Delete a third-party link
 yutu thirdPartyLink delete --linkingToken abc123 --type channelToStoreLink`
 )

cmd/thirdPartyLink/insert.go

@@ -20,9 +20,9 @@ import (
 
 const (
 	insertTool    = "thirdPartyLink-insert"
-	insertConfirm = "Insert third-party link: %s"
-	insertShort   = "Insert a new third-party link"
-	insertLong    = "Insert a new third-party link. Use this tool to create a link between a YouTube channel and a third-party service."
+	insertConfirm = "Create third-party link: %s"
+	insertShort   = "Create a third-party link"
+	insertLong    = "Create a third-party link. Use this tool to create a third-party link."
 	insertExample = `# Insert a new third-party link
 yutu thirdPartyLink insert --linkingToken abc123 --type channelToStoreLink --linkStatus pending --parts snippet,status`
 )

cmd/video/insert.go

@@ -21,7 +21,7 @@ import (
 const (
 	insertTool      = "video-insert"
 	insertLangUsage = "Language of the video"
-	insertConfirm   = "Insert video: %s"
+	insertConfirm   = "Upload video: %s"
 	insertShort     = "Upload a video"
 	insertLong      = "Upload a video. Use this tool to upload a video."
 	insertExample   = `# Upload a public video

cmd/video/list.go

@@ -21,8 +21,8 @@ const (
 	listTool     = "video-list"
 	listIdsUsage = "Return videos with the given ids"
 	listMrUsage  = "Return videos liked/disliked by the authenticated user"
-	listShort    = "List video information"
-	listLong     = "List video information. Use this tool to list video information."
+	listShort    = "List videos"
+	listLong     = "List videos. Use this tool to list videos."
 	listExample  = `# List a video by ID
 yutu video list --ids IBju0NwjQRc
 # List multiple videos in JSON format

cmd/watermark/set.go

@@ -20,8 +20,8 @@ import (
 const (
 	setTool    = "watermark-set"
 	setConfirm = "Set watermark for channel: %s"
-	setShort   = "Set a watermark for channel's videos"
-	setLong    = "Set a watermark for channel's videos. Use this tool to set a watermark for channel's videos."
+	setShort   = "Set a channel watermark"
+	setLong    = "Set a channel watermark. Use this tool to set a channel watermark."
 	setExample = `# Set a watermark for a channel
 yutu watermark set --channelId UC_x5XG1OV2P6uZZ5FSM9Ttw --file watermark.png
 # Set a watermark with position and offset

cmd/watermark/unset.go

@@ -20,8 +20,8 @@ import (
 const (
 	unsetTool    = "watermark-unset"
 	unsetConfirm = "Unset watermark for channel: %s"
-	unsetShort   = "Unset a watermark for channel's videos"
-	unsetLong    = "Unset a watermark for channel's videos. Use this tool to unset a watermark for a channel's videos."
+	unsetShort   = "Unset a channel watermark"
+	unsetLong    = "Unset a channel watermark. Use this tool to unset a channel watermark."
 	unsetExample = `# Unset watermark for a channel
 yutu watermark unset --channelId UC_x5XG1OV2P6uZZ5FSM9Ttw`
 )