From 3f36d90cd259ecd69455d8669682d4a08f0a1512 Mon Sep 17 00:00:00 2001
From: OpenWaygate <27287694+OpenWaygate@users.noreply.github.com>
Date: Mon, 9 Mar 2026 21:06:03 +0800
Subject: [PATCH] :speech_balloon: Simplify long description

---
 cmd/activity/list.go               | 2 +-
 cmd/caption/delete.go              | 2 +-
 cmd/caption/download.go            | 2 +-
 cmd/caption/insert.go              | 2 +-
 cmd/caption/list.go                | 2 +-
 cmd/caption/update.go              | 2 +-
 cmd/channel/list.go                | 2 +-
 cmd/channel/update.go              | 2 +-
 cmd/channelBanner/insert.go        | 2 +-
 cmd/channelSection/delete.go       | 2 +-
 cmd/channelSection/list.go         | 2 +-
 cmd/comment/delete.go              | 2 +-
 cmd/comment/insert.go              | 2 +-
 cmd/comment/list.go                | 2 +-
 cmd/comment/markAsSpam.go          | 2 +-
 cmd/comment/setModerationStatus.go | 2 +-
 cmd/comment/update.go              | 2 +-
 cmd/commentThread/insert.go        | 2 +-
 cmd/commentThread/list.go          | 2 +-
 cmd/i18nLanguage/list.go           | 2 +-
 cmd/i18nRegion/list.go             | 2 +-
 cmd/member/list.go                 | 2 +-
 cmd/membershipsLevel/list.go       | 2 +-
 cmd/playlist/delete.go             | 2 +-
 cmd/playlist/insert.go             | 2 +-
 cmd/playlist/list.go               | 2 +-
 cmd/playlist/update.go             | 2 +-
 cmd/playlistImage/delete.go        | 2 +-
 cmd/playlistImage/insert.go        | 2 +-
 cmd/playlistImage/list.go          | 2 +-
 cmd/playlistImage/update.go        | 2 +-
 cmd/playlistItem/delete.go         | 2 +-
 cmd/playlistItem/insert.go         | 2 +-
 cmd/playlistItem/list.go           | 2 +-
 cmd/playlistItem/update.go         | 2 +-
 cmd/search/list.go                 | 2 +-
 cmd/subscription/delete.go         | 2 +-
 cmd/subscription/insert.go         | 2 +-
 cmd/subscription/list.go           | 2 +-
 cmd/superChatEvent/list.go         | 2 +-
 cmd/thumbnail/set.go               | 2 +-
 cmd/video/delete.go                | 2 +-
 cmd/video/getRating.go             | 2 +-
 cmd/video/insert.go                | 2 +-
 cmd/video/list.go                  | 2 +-
 cmd/video/rate.go                  | 2 +-
 cmd/video/reportAbuse.go           | 2 +-
 cmd/video/update.go                | 2 +-
 cmd/videoAbuseReportReason/list.go | 2 +-
 cmd/videoCategory/list.go          | 2 +-
 cmd/watermark/set.go               | 2 +-
 cmd/watermark/unset.go             | 2 +-
 52 files changed, 52 insertions(+), 52 deletions(-)

diff --git a/cmd/activity/list.go b/cmd/activity/list.go
index f7af01a..7df80fa 100644
--- a/cmd/activity/list.go
+++ b/cmd/activity/list.go
@@ -20,7 +20,7 @@ import (
 const (
 	listTool    = "activity-list"
 	listShort   = "List activities"
-	listLong    = "List activities. Use this tool when you need to list activities such as uploads, likes, and favorites."
+	listLong    = "List activities. Use this tool to list activities such as uploads, likes, and favorites."
 	listExample = `# List my activities
 yutu activity list --mine
 # List activities by channel ID with limit
diff --git a/cmd/caption/delete.go b/cmd/caption/delete.go
index 4d1e81d..aad11b8 100644
--- a/cmd/caption/delete.go
+++ b/cmd/caption/delete.go
@@ -20,7 +20,7 @@ const (
 	deleteTool     = "caption-delete"
 	deleteIdsUsage = "IDs of the captions to delete"
 	deleteShort    = "Delete captions"
-	deleteLong     = "Delete captions. Use this tool when you need to delete captions of a video by IDs."
+	deleteLong     = "Delete captions. Use this tool to delete captions of a video by IDs."
 	deleteExample  = `# Delete a caption by ID
 yutu caption delete --ids abc123
 # Delete multiple captions
diff --git a/cmd/caption/download.go b/cmd/caption/download.go
index 53f2544..965cb7a 100644
--- a/cmd/caption/download.go
+++ b/cmd/caption/download.go
@@ -20,7 +20,7 @@ const (
 	downloadTool    = "caption-download"
 	downloadIdUsage = "ID of the caption to download"
 	downloadShort   = "Download a caption"
-	downloadLong    = "Download a caption. Use this tool when you need to download a caption from a video."
+	downloadLong    = "Download a caption. Use this tool to download a caption from a video."
 	downloadExample = `# Download a caption as SRT
 yutu caption download --id abc123 --file subtitle.srt
 # Download a caption as VTT
diff --git a/cmd/caption/insert.go b/cmd/caption/insert.go
index 4086c73..1d217fb 100644
--- a/cmd/caption/insert.go
+++ b/cmd/caption/insert.go
@@ -20,7 +20,7 @@ import (
 const (
 	insertTool    = "caption-insert"
 	insertShort   = "Insert a caption"
-	insertLong    = "Insert a caption. Use this tool when you need to insert a caption to a video."
+	insertLong    = "Insert a caption. Use this tool to insert 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
diff --git a/cmd/caption/list.go b/cmd/caption/list.go
index 7981c48..8a07a7f 100644
--- a/cmd/caption/list.go
+++ b/cmd/caption/list.go
@@ -21,7 +21,7 @@ const (
 	listTool     = "caption-list"
 	listIdsUsage = "IDs of the captions to list"
 	listShort    = "List captions"
-	listLong     = "List captions. Use this tool when you need to list captions of a video."
+	listLong     = "List captions. Use this tool to list captions of a video."
 	listExample  = `# List captions of a video
 yutu caption list --videoId dQw4w9WgXcQ
 # List captions in JSON format
diff --git a/cmd/caption/update.go b/cmd/caption/update.go
index edd37da..9b8350f 100644
--- a/cmd/caption/update.go
+++ b/cmd/caption/update.go
@@ -20,7 +20,7 @@ import (
 const (
 	updateTool    = "caption-update"
 	updateShort   = "Update a video caption"
-	updateLong    = "Update a video caption. Use this tool when you need to update a video caption."
+	updateLong    = "Update a video caption. Use this tool to update a video caption."
 	updateExample = `# Publish a draft caption
 yutu caption update --videoId dQw4w9WgXcQ --isDraft=false
 # Update caption language and name
diff --git a/cmd/channel/list.go b/cmd/channel/list.go
index 4d2660b..299a530 100644
--- a/cmd/channel/list.go
+++ b/cmd/channel/list.go
@@ -21,7 +21,7 @@ const (
 	listTool     = "channel-list"
 	listIdsUsage = "Return the channels with the specified Ids"
 	listShort    = "List channel information"
-	listLong     = "List channel information. Use this tool when you need to list channel information."
+	listLong     = "List channel information. Use this tool to list channel information."
 	listExample  = `# List my channel info
 yutu channel list --mine
 # List channel by handle
diff --git a/cmd/channel/update.go b/cmd/channel/update.go
index f0ff086..aead72a 100644
--- a/cmd/channel/update.go
+++ b/cmd/channel/update.go
@@ -21,7 +21,7 @@ const (
 	updateTool    = "channel-update"
 	updateIdUsage = "ID of the channel to update"
 	updateShort   = "Update channel information"
-	updateLong    = "Update channel information. Use this tool when you need to update channel information."
+	updateLong    = "Update channel information. Use this tool to update channel information."
 	updateExample = `# Update channel description
 yutu channel update --id UC_x5XG1OV2P6uZZ5FSM9Ttw --description 'New description'
 # Update channel title and country
diff --git a/cmd/channelBanner/insert.go b/cmd/channelBanner/insert.go
index 8405600..e3a62d7 100644
--- a/cmd/channelBanner/insert.go
+++ b/cmd/channelBanner/insert.go
@@ -20,7 +20,7 @@ import (
 const (
 	insertTool    = "channelBanner-insert"
 	insertShort   = "Insert a channel banner"
-	insertLong    = "Insert a channel banner. Use this tool when you need to upload a channel banner."
+	insertLong    = "Insert 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
diff --git a/cmd/channelSection/delete.go b/cmd/channelSection/delete.go
index 247b2bd..fc02981 100644
--- a/cmd/channelSection/delete.go
+++ b/cmd/channelSection/delete.go
@@ -20,7 +20,7 @@ const (
 	deleteTool     = "channelSection-delete"
 	deleteIdsUsage = "Delete the channel sections with the given ids"
 	deleteShort    = "Delete channel sections"
-	deleteLong     = "Delete channel sections. Use this tool when you need to delete channel sections by IDs."
+	deleteLong     = "Delete channel sections. Use this tool to delete channel sections by IDs."
 	deleteExample  = `# Delete a channel section by ID
 yutu channelSection delete --ids abc123
 # Delete multiple channel sections
diff --git a/cmd/channelSection/list.go b/cmd/channelSection/list.go
index e122014..7a3d357 100644
--- a/cmd/channelSection/list.go
+++ b/cmd/channelSection/list.go
@@ -21,7 +21,7 @@ const (
 	listTool     = "channelSection-list"
 	listIdsUsage = "Return the channel sections with the given ids"
 	listShort    = "List channel sections"
-	listLong     = "List channel sections. Use this tool when you need to list channel sections."
+	listLong     = "List channel sections. Use this tool to list channel sections."
 	listExample  = `# List my channel sections
 yutu channelSection list --mine
 # List channel sections by channel ID
diff --git a/cmd/comment/delete.go b/cmd/comment/delete.go
index 93b2f8e..6a7131a 100644
--- a/cmd/comment/delete.go
+++ b/cmd/comment/delete.go
@@ -18,7 +18,7 @@ import (
 const (
 	deleteTool    = "comment-delete"
 	deleteShort   = "Delete comments"
-	deleteLong    = "Delete comments. Use this tool when you need to delete comments by IDs."
+	deleteLong    = "Delete comments. Use this tool to delete comments by IDs."
 	deleteExample = `# Delete a comment by ID
 yutu comment delete --ids abc123
 # Delete multiple comments
diff --git a/cmd/comment/insert.go b/cmd/comment/insert.go
index 78435b8..5fb8c9a 100644
--- a/cmd/comment/insert.go
+++ b/cmd/comment/insert.go
@@ -21,7 +21,7 @@ const (
 	insertTool     = "comment-insert"
 	insertPidUsage = "ID of the parent comment"
 	insertShort    = "Create a comment"
-	insertLong     = "Create a comment. Use this tool when you need to create a comment on a video."
+	insertLong     = "Create a comment. Use this tool to create a comment on a video."
 	insertExample  = `# Reply to a comment
 yutu comment insert --channelId UC_x5X --videoId dQw4w9 --authorChannelId UA_x5X --parentId UgyXXX --textOriginal 'Hello'
 # Reply with rating enabled
diff --git a/cmd/comment/list.go b/cmd/comment/list.go
index 7468d27..22e6906 100644
--- a/cmd/comment/list.go
+++ b/cmd/comment/list.go
@@ -21,7 +21,7 @@ const (
 	listTool     = "comment-list"
 	listPidUsage = "Returns replies to the specified comment"
 	listShort    = "List comments"
-	listLong     = "List comments. Use this tool when you need to list comments by IDs."
+	listLong     = "List comments. Use this tool to list comments by IDs."
 	listExample  = `# List replies to a comment
 yutu comment list --parentId UgyXXXXXXXX --maxResults 10
 # List specific comments in JSON format
diff --git a/cmd/comment/markAsSpam.go b/cmd/comment/markAsSpam.go
index 0f3f126..a8c60a6 100644
--- a/cmd/comment/markAsSpam.go
+++ b/cmd/comment/markAsSpam.go
@@ -20,7 +20,7 @@ import (
 const (
 	masTool    = "comment-markAsSpam"
 	masShort   = "Mark comments as spam"
-	masLong    = "Mark comments as spam. Use this tool when you need to mark comments as spam."
+	masLong    = "Mark comments as spam. Use this tool to mark comments as spam."
 	masExample = `# Mark a comment as spam
 yutu comment markAsSpam --ids abc123
 # Mark multiple comments as spam
diff --git a/cmd/comment/setModerationStatus.go b/cmd/comment/setModerationStatus.go
index 4ba2514..79674c1 100644
--- a/cmd/comment/setModerationStatus.go
+++ b/cmd/comment/setModerationStatus.go
@@ -20,7 +20,7 @@ import (
 const (
 	smsTool    = "comment-setModerationStatus"
 	smsShort   = "Set comment moderation status"
-	smsLong    = "Set comment moderation status. Use this tool when you need to set comment moderation status."
+	smsLong    = "Set comment moderation status. Use this tool to set comment moderation status."
 	smsExample = `# Publish a held comment
 yutu comment setModerationStatus --ids abc123 --moderationStatus published
 # Hold multiple comments for review
diff --git a/cmd/comment/update.go b/cmd/comment/update.go
index bdef7b1..08d9f4a 100644
--- a/cmd/comment/update.go
+++ b/cmd/comment/update.go
@@ -21,7 +21,7 @@ const (
 	updateTool    = "comment-update"
 	updateIdUsage = "ID of the comment"
 	updateShort   = "Update a comment on a video"
-	updateLong    = "Update a comment on a video. Use this tool when you need to update a comment on a video."
+	updateLong    = "Update a comment on a video. Use this tool to update a comment on a video."
 	updateExample = `# Update comment text
 yutu comment update --id abc123 --textOriginal 'Updated comment'
 # Like a comment
diff --git a/cmd/commentThread/insert.go b/cmd/commentThread/insert.go
index 8d1f3bb..cd83408 100644
--- a/cmd/commentThread/insert.go
+++ b/cmd/commentThread/insert.go
@@ -21,7 +21,7 @@ const (
 	insertTool     = "commentThread-insert"
 	insertVidUsage = "ID of the video"
 	insertShort    = "Insert a new comment thread"
-	insertLong     = "Insert a new comment thread. Use this tool when you need to insert a new comment thread."
+	insertLong     = "Insert a new comment thread. Use this tool to insert a new 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
diff --git a/cmd/commentThread/list.go b/cmd/commentThread/list.go
index 3d1ee69..0973b3d 100644
--- a/cmd/commentThread/list.go
+++ b/cmd/commentThread/list.go
@@ -21,7 +21,7 @@ const (
 	listTool     = "commentThread-list"
 	listVidUsage = "Returns the comment threads of the specified video"
 	listShort    = "List comment threads"
-	listLong     = "List comment threads. Use this tool when you need to list comment threads."
+	listLong     = "List comment threads. Use this tool to list comment threads."
 	listExample  = `# List comment threads on a video
 yutu commentThread list --videoId dQw4w9WgXcQ --maxResults 10
 # Search comment threads by terms
diff --git a/cmd/i18nLanguage/list.go b/cmd/i18nLanguage/list.go
index c52b0ed..ace8f9b 100644
--- a/cmd/i18nLanguage/list.go
+++ b/cmd/i18nLanguage/list.go
@@ -17,7 +17,7 @@ import (
 
 const (
 	listShort = "List i18n languages"
-	listLong  = `List i18n languages. Use this tool when you need to list available internationalization languages.`
+	listLong  = `List i18n languages. Use this tool to list available internationalization languages.`
 )
 
 func init() {
diff --git a/cmd/i18nRegion/list.go b/cmd/i18nRegion/list.go
index 1f4d014..c728da0 100644
--- a/cmd/i18nRegion/list.go
+++ b/cmd/i18nRegion/list.go
@@ -17,7 +17,7 @@ import (
 
 const (
 	listShort = "List i18n regions"
-	listLong  = `List i18n regions. Use this tool when you need to list available internationalization regions.`
+	listLong  = `List i18n regions. Use this tool to list available internationalization regions.`
 )
 
 func init() {
diff --git a/cmd/member/list.go b/cmd/member/list.go
index 0a332d0..0f7e303 100644
--- a/cmd/member/list.go
+++ b/cmd/member/list.go
@@ -20,7 +20,7 @@ import (
 const (
 	listTool    = "member-list"
 	listShort   = "List channel members"
-	listLong    = "List channel members. Use this tool when you need to list information about channel members."
+	listLong    = "List channel members. Use this tool to list information about channel members."
 	listExample = `# List all current members
 yutu member list --mode all_current
 # List members with limit
diff --git a/cmd/membershipsLevel/list.go b/cmd/membershipsLevel/list.go
index 11dc3e2..2789ca1 100644
--- a/cmd/membershipsLevel/list.go
+++ b/cmd/membershipsLevel/list.go
@@ -20,7 +20,7 @@ import (
 const (
 	listTool    = "membershipsLevel-list"
 	listShort   = "List memberships levels"
-	listLong    = "List memberships levels. Use this tool when you need to list information about channel membership levels."
+	listLong    = "List memberships levels. Use this tool to list information about channel membership levels."
 	listExample = `# List membership levels in JSON format
 yutu membershipsLevel list --output json`
 )
diff --git a/cmd/playlist/delete.go b/cmd/playlist/delete.go
index 627b1fc..99759da 100644
--- a/cmd/playlist/delete.go
+++ b/cmd/playlist/delete.go
@@ -20,7 +20,7 @@ const (
 	deleteTool     = "playlist-delete"
 	deleteIdsUsage = "IDs of the playlists to delete"
 	deleteShort    = "Delete playlists"
-	deleteLong     = "Delete playlists. Use this tool when you need to delete playlists by IDs."
+	deleteLong     = "Delete playlists. Use this tool to delete playlists by IDs."
 	deleteExample  = `# Delete a playlist by ID
 yutu playlist delete --ids PLxxxx
 # Delete multiple playlists
diff --git a/cmd/playlist/insert.go b/cmd/playlist/insert.go
index 5664db8..8d1b367 100644
--- a/cmd/playlist/insert.go
+++ b/cmd/playlist/insert.go
@@ -21,7 +21,7 @@ const (
 	insertTool     = "playlist-insert"
 	insertCidUsage = "Channel id of the playlist"
 	insertShort    = "Create a new playlist"
-	insertLong     = "Create a new playlist. Use this tool when you need to create a new playlist."
+	insertLong     = "Create a new playlist. Use this tool to create a new playlist."
 	insertExample  = `# Create a public playlist
 yutu playlist insert --title 'My Playlist' --channelId UC_x5XG1OV2P6uZZ5FSM9Ttw --privacy public
 # Create a private playlist with description
diff --git a/cmd/playlist/list.go b/cmd/playlist/list.go
index 1bf9f67..e05c147 100644
--- a/cmd/playlist/list.go
+++ b/cmd/playlist/list.go
@@ -22,7 +22,7 @@ const (
 	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 when you need to list playlist information."
+	listLong     = "List playlist information. Use this tool to list playlist information."
 	listExample  = `# List my playlists
 yutu playlist list --mine
 # List playlists by channel ID with limit
diff --git a/cmd/playlist/update.go b/cmd/playlist/update.go
index 02f763e..95a1484 100644
--- a/cmd/playlist/update.go
+++ b/cmd/playlist/update.go
@@ -21,7 +21,7 @@ const (
 	updateTool    = "playlist-update"
 	updateIdUsage = "ID of the playlist to update"
 	updateShort   = "Update a playlist"
-	updateLong    = "Update a playlist. Use this tool when you need to update a playlist."
+	updateLong    = "Update a playlist. Use this tool to update a playlist."
 	updateExample = `# Update playlist title
 yutu playlist update --id PLxxx --title 'Updated Title'
 # Update playlist description and privacy
diff --git a/cmd/playlistImage/delete.go b/cmd/playlistImage/delete.go
index 97e4db2..420ff6b 100644
--- a/cmd/playlistImage/delete.go
+++ b/cmd/playlistImage/delete.go
@@ -19,7 +19,7 @@ import (
 const (
 	deleteTool    = "playlistImage-delete"
 	deleteShort   = "Delete playlist images"
-	deleteLong    = "Delete playlist images. Use this tool when you need to delete playlist images by IDs."
+	deleteLong    = "Delete playlist images. Use this tool to delete playlist images by IDs."
 	deleteExample = `# Delete a playlist image by ID
 yutu playlistImage delete --ids abc123
 # Delete multiple playlist images
diff --git a/cmd/playlistImage/insert.go b/cmd/playlistImage/insert.go
index d8fa04e..947e538 100644
--- a/cmd/playlistImage/insert.go
+++ b/cmd/playlistImage/insert.go
@@ -20,7 +20,7 @@ import (
 const (
 	insertTool    = "playlistImage-insert"
 	insertShort   = "Insert a playlist image"
-	insertLong    = "Insert a playlist image. Use this tool when you need to insert a YouTube playlist image for a given playlist ID."
+	insertLong    = "Insert a playlist image. Use this tool to insert a YouTube playlist image for a given playlist ID."
 	insertExample = `# Insert a playlist cover image
 yutu playlistImage insert --file cover.jpg --playlistId PLxxx
 # Insert a hero image
diff --git a/cmd/playlistImage/list.go b/cmd/playlistImage/list.go
index 430758e..9eef3d9 100644
--- a/cmd/playlistImage/list.go
+++ b/cmd/playlistImage/list.go
@@ -20,7 +20,7 @@ import (
 const (
 	listTool    = "playlistImage-list"
 	listShort   = "List playlist images"
-	listLong    = "List playlist images. Use this tool when you need to list playlist images."
+	listLong    = "List playlist images. Use this tool to list playlist images."
 	listExample = `# List images of a playlist
 yutu playlistImage list --parent PLxxx
 # List playlist images with limit in JSON format
diff --git a/cmd/playlistImage/update.go b/cmd/playlistImage/update.go
index 89cbd4d..06083c5 100644
--- a/cmd/playlistImage/update.go
+++ b/cmd/playlistImage/update.go
@@ -20,7 +20,7 @@ import (
 const (
 	updateTool    = "playlistImage-update"
 	updateShort   = "Update a playlist image"
-	updateLong    = "Update a playlist image. Use this tool when you need to update a playlist image."
+	updateLong    = "Update a playlist image. Use this tool to update a playlist image."
 	updateExample = `# Update a playlist image
 yutu playlistImage update --playlistId PLxxx --type hero --width 2048 --height 1152`
 )
diff --git a/cmd/playlistItem/delete.go b/cmd/playlistItem/delete.go
index 1f2140f..e62449a 100644
--- a/cmd/playlistItem/delete.go
+++ b/cmd/playlistItem/delete.go
@@ -20,7 +20,7 @@ const (
 	deleteTool     = "playlistItem-delete"
 	deleteIdsUsage = "IDs of the playlist items to delete"
 	deleteShort    = "Delete items from a playlist"
-	deleteLong     = "Delete items from a playlist. Use this tool when you need to delete items from a playlist by IDs."
+	deleteLong     = "Delete items from a playlist. Use this tool to delete items from a playlist by IDs."
 	deleteExample  = `# Delete a playlist item by ID
 yutu playlistItem delete --ids abc123
 # Delete multiple playlist items
diff --git a/cmd/playlistItem/insert.go b/cmd/playlistItem/insert.go
index 45340b8..fb57ab1 100644
--- a/cmd/playlistItem/insert.go
+++ b/cmd/playlistItem/insert.go
@@ -21,7 +21,7 @@ const (
 	insertTool     = "playlistItem-insert"
 	insertPidUsage = "The id that YouTube uses to uniquely identify the playlist that the item is in"
 	insertShort    = "Insert a playlist item into a playlist"
-	insertLong     = "Insert a playlist item into a playlist. Use this tool when you need to 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."
 	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
diff --git a/cmd/playlistItem/list.go b/cmd/playlistItem/list.go
index ca9bbf5..dcf5fb5 100644
--- a/cmd/playlistItem/list.go
+++ b/cmd/playlistItem/list.go
@@ -22,7 +22,7 @@ const (
 	listIdsUsage = "IDs of the playlist items to list"
 	listPidUsage = "Return the playlist items within the given playlist"
 	listShort    = "List playlist items"
-	listLong     = "List playlist items. Use this tool when you need to list playlist items."
+	listLong     = "List playlist items. Use this tool to list playlist items."
 	listExample  = `# List items in a playlist
 yutu playlistItem list --playlistId PLxxx
 # List playlist items with limit in JSON format
diff --git a/cmd/playlistItem/update.go b/cmd/playlistItem/update.go
index 7463aef..dd05eed 100644
--- a/cmd/playlistItem/update.go
+++ b/cmd/playlistItem/update.go
@@ -21,7 +21,7 @@ const (
 	updateTool    = "playlistItem-update"
 	updateIdUsage = "ID of the playlist item to update"
 	updateShort   = "Update a playlist item"
-	updateLong    = "Update a playlist item. Use this tool when you need to update a playlist item."
+	updateLong    = "Update a playlist item. Use this tool to update a playlist item."
 	updateExample = `# Update playlist item title
 yutu playlistItem update --id abc123 --title 'Updated Title'
 # Update playlist item description and privacy
diff --git a/cmd/search/list.go b/cmd/search/list.go
index 0b20c62..4045b84 100644
--- a/cmd/search/list.go
+++ b/cmd/search/list.go
@@ -20,7 +20,7 @@ import (
 const (
 	listTool    = "search-list"
 	listShort   = "Search resources"
-	listLong    = "Search resources. Use this tool when you need to search for videos, channels, playlists, and other resources."
+	listLong    = "Search resources. Use this tool to search for videos, channels, playlists, and other resources."
 	listExample = `# Search for videos by keyword
 yutu search list --q 'golang tutorial' --maxResults 10
 # Search videos by duration in JSON format
diff --git a/cmd/subscription/delete.go b/cmd/subscription/delete.go
index 411df5e..5d0d0aa 100644
--- a/cmd/subscription/delete.go
+++ b/cmd/subscription/delete.go
@@ -19,7 +19,7 @@ const (
 	deleteTool     = "subscription-delete"
 	deleteIdsUsage = "IDs of the subscriptions to delete"
 	deleteShort    = "Delete subscriptions"
-	deleteLong     = "Delete subscriptions. Use this tool when you need to delete subscriptions by IDs."
+	deleteLong     = "Delete subscriptions. Use this tool to delete subscriptions by IDs."
 	deleteExample  = `# Delete a subscription by ID
 yutu subscription delete --ids abc123
 # Delete multiple subscriptions
diff --git a/cmd/subscription/insert.go b/cmd/subscription/insert.go
index c091190..a8ff388 100644
--- a/cmd/subscription/insert.go
+++ b/cmd/subscription/insert.go
@@ -21,7 +21,7 @@ const (
 	insertTool     = "subscription-insert"
 	insertCidUsage = "ID of the channel to be subscribed"
 	insertShort    = "Insert a new subscription"
-	insertLong     = "Insert a new subscription. Use this tool when you need to insert a new subscription."
+	insertLong     = "Insert a new subscription. Use this tool to insert a new subscription."
 	insertExample  = `# Subscribe to a channel
 yutu subscription insert --subscriberChannelId UC_abc --channelId UC_x5XG1OV2P6uZZ5FSM9Ttw
 # Subscribe with a title
diff --git a/cmd/subscription/list.go b/cmd/subscription/list.go
index 72ab204..bc97eff 100644
--- a/cmd/subscription/list.go
+++ b/cmd/subscription/list.go
@@ -22,7 +22,7 @@ const (
 	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 when you need to list subscription information."
+	listLong     = "List subscription information. Use this tool to list subscription information."
 	listExample  = `# List my subscriptions
 yutu subscription list --mine
 # List subscriptions by channel ID with limit
diff --git a/cmd/superChatEvent/list.go b/cmd/superChatEvent/list.go
index c3f1c00..120c214 100644
--- a/cmd/superChatEvent/list.go
+++ b/cmd/superChatEvent/list.go
@@ -20,7 +20,7 @@ import (
 const (
 	listTool    = "superChatEvent-list"
 	listShort   = "List Super Chat events"
-	listLong    = "List Super Chat events. Use this tool when you need to list Super Chat events."
+	listLong    = "List Super Chat events. Use this tool to list Super Chat events."
 	listExample = `# List Super Chat events
 yutu superChatEvent list --maxResults 10`
 )
diff --git a/cmd/thumbnail/set.go b/cmd/thumbnail/set.go
index bc8eee2..9da12bf 100644
--- a/cmd/thumbnail/set.go
+++ b/cmd/thumbnail/set.go
@@ -20,7 +20,7 @@ import (
 const (
 	setTool    = "thumbnail-set"
 	setShort   = "Set a thumbnail for a video"
-	setLong    = "Set a thumbnail for a video. Use this tool when you need to set a thumbnail for a video."
+	setLong    = "Set a thumbnail for a video. Use this tool to set a thumbnail for a video."
 	setExample = `# Set a thumbnail for a video
 yutu thumbnail set --file image.jpg --videoId dQw4w9WgXcQ
 # Set a thumbnail with JSON output
diff --git a/cmd/video/delete.go b/cmd/video/delete.go
index 0854809..580fcc0 100644
--- a/cmd/video/delete.go
+++ b/cmd/video/delete.go
@@ -19,7 +19,7 @@ const (
 	deleteTool     = "video-delete"
 	deleteIdsUsage = "IDs of the videos to delete"
 	deleteShort    = "Delete videos"
-	deleteLong     = "Delete videos. Use this tool when you need to delete videos by IDs."
+	deleteLong     = "Delete videos. Use this tool to delete videos by IDs."
 	deleteExample  = `# Delete a video by ID
 yutu video delete --ids dQw4w9WgXcQ
 # Delete multiple videos
diff --git a/cmd/video/getRating.go b/cmd/video/getRating.go
index 0b67e69..55c58b8 100644
--- a/cmd/video/getRating.go
+++ b/cmd/video/getRating.go
@@ -21,7 +21,7 @@ const (
 	getRatingTool    = "video-getRating"
 	grIdsUsage       = "IDs of the videos to get the rating for"
 	getRatingShort   = "Get video ratings"
-	getRatingLong    = "Get video ratings. Use this tool when you need to get video ratings by IDs."
+	getRatingLong    = "Get video ratings. Use this tool to get video ratings by IDs."
 	getRatingExample = `# Get rating of a video
 yutu video getRating --ids dQw4w9WgXcQ
 # Get ratings of multiple videos in JSON format
diff --git a/cmd/video/insert.go b/cmd/video/insert.go
index f40ff01..0cbba67 100644
--- a/cmd/video/insert.go
+++ b/cmd/video/insert.go
@@ -21,7 +21,7 @@ const (
 	insertTool      = "video-insert"
 	insertLangUsage = "Language of the video"
 	insertShort     = "Upload a video"
-	insertLong      = "Upload a video. Use this tool when you need to upload a video."
+	insertLong      = "Upload a video. Use this tool to upload a video."
 	insertExample   = `# Upload a public video
 yutu video insert --file video.mp4 --title 'My Video' --categoryId 22 --privacy public
 # Upload a private video with tags
diff --git a/cmd/video/list.go b/cmd/video/list.go
index 6a7df85..3915d73 100644
--- a/cmd/video/list.go
+++ b/cmd/video/list.go
@@ -22,7 +22,7 @@ const (
 	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 when you need to list video information."
+	listLong     = "List video information. Use this tool to list video information."
 	listExample  = `# List a video by ID
 yutu video list --ids dQw4w9WgXcQ
 # List multiple videos in JSON format
diff --git a/cmd/video/rate.go b/cmd/video/rate.go
index 36a12b5..b10fe89 100644
--- a/cmd/video/rate.go
+++ b/cmd/video/rate.go
@@ -20,7 +20,7 @@ const (
 	rateIdsUsage = "IDs of the videos to rate"
 	rateRUsage   = "like|dislike|none"
 	rateShort    = "Rate a video"
-	rateLong     = "Rate a video. Use this tool when you need to rate a video."
+	rateLong     = "Rate a video. Use this tool to rate a video."
 	rateExample  = `# Like a video
 yutu video rate --ids dQw4w9WgXcQ --rating like
 # Dislike multiple videos
diff --git a/cmd/video/reportAbuse.go b/cmd/video/reportAbuse.go
index 7593675..743219c 100644
--- a/cmd/video/reportAbuse.go
+++ b/cmd/video/reportAbuse.go
@@ -21,7 +21,7 @@ const (
 	raIdsUsage         = "IDs of the videos to report abuse on"
 	raLangUsage        = "Language that the content was viewed in"
 	reportAbuseShort   = "Report abuse on a video"
-	reportAbuseLong    = "Report abuse on a video. Use this tool when you need to report abuse on a video."
+	reportAbuseLong    = "Report abuse on a video. Use this tool to report abuse on a video."
 	reportAbuseExample = `# Report abuse on a video
 yutu video reportAbuse --ids dQw4w9WgXcQ --reasonId V
 # Report abuse with secondary reason and language
diff --git a/cmd/video/update.go b/cmd/video/update.go
index ff02855..f39f630 100644
--- a/cmd/video/update.go
+++ b/cmd/video/update.go
@@ -22,7 +22,7 @@ const (
 	updateIdUsage   = "ID of the video to update"
 	updateLangUsage = "Language of the video"
 	updateShort     = "Update a video"
-	updateLong      = "Update a video. Use this tool when you need to update a video."
+	updateLong      = "Update a video. Use this tool to update a video."
 	updateExample   = `# Update video title
 yutu video update --id dQw4w9WgXcQ --title 'New Title'
 # Update video description and privacy
diff --git a/cmd/videoAbuseReportReason/list.go b/cmd/videoAbuseReportReason/list.go
index 05ce0ed..eff4ab2 100644
--- a/cmd/videoAbuseReportReason/list.go
+++ b/cmd/videoAbuseReportReason/list.go
@@ -20,7 +20,7 @@ import (
 const (
 	listTool    = "videoAbuseReportReason-list"
 	listShort   = "List video abuse report reasons"
-	listLong    = "List video abuse report reasons. Use this tool when you need to list available abuse report reasons."
+	listLong    = "List video abuse report reasons. Use this tool to list available abuse report reasons."
 	listExample = `# List video abuse report reasons
 yutu videoAbuseReportReason list --hl en`
 )
diff --git a/cmd/videoCategory/list.go b/cmd/videoCategory/list.go
index 25c239f..71750cd 100644
--- a/cmd/videoCategory/list.go
+++ b/cmd/videoCategory/list.go
@@ -41,7 +41,7 @@ func init() {
 
 const (
 	listShort = "List video categories"
-	listLong  = `List video categories. Use this tool when you need to list available video categories.`
+	listLong  = `List video categories. Use this tool to list available video categories.`
 )
 
 var listCmd = &cobra.Command{
diff --git a/cmd/watermark/set.go b/cmd/watermark/set.go
index 035525e..2e45181 100644
--- a/cmd/watermark/set.go
+++ b/cmd/watermark/set.go
@@ -19,7 +19,7 @@ import (
 const (
 	setTool    = "watermark-set"
 	setShort   = "Set a watermark for channel's videos"
-	setLong    = "Set a watermark for channel's videos. Use this tool when you need to 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."
 	setExample = `# Set a watermark for a channel
 yutu watermark set --channelId UC_x5XG1OV2P6uZZ5FSM9Ttw --file watermark.png
 # Set a watermark with position and offset
diff --git a/cmd/watermark/unset.go b/cmd/watermark/unset.go
index 5536454..295e281 100644
--- a/cmd/watermark/unset.go
+++ b/cmd/watermark/unset.go
@@ -18,7 +18,7 @@ import (
 const (
 	unsetTool    = "watermark-unset"
 	unsetShort   = "Unset a watermark for channel's videos"
-	unsetLong    = "Unset a watermark for channel's videos. Use this tool when you need to unset a watermark for a channel's videos."
+	unsetLong    = "Unset a watermark for channel's videos. Use this tool to unset a watermark for a channel's videos."
 	unsetExample = `# Unset watermark for a channel
 yutu watermark unset --channelId UC_x5XG1OV2P6uZZ5FSM9Ttw`
 )