improve description

Author: tonytrg

pkg/github/issues.go

@@ -1770,36 +1770,36 @@ func AssignCodingAgentPrompt(t translations.TranslationHelperFunc) (tool mcp.Pro
 
 // Label Management
 
-// CRUDLabel consolidates Create/Get/Update/Delete label operations into a single tool.
-func CRUDLabel(getGQLClient GetGQLClientFn, t translations.TranslationHelperFunc) (mcp.Tool, server.ToolHandlerFunc) {
-	return mcp.NewTool("crud_label",
-			mcp.WithDescription(t("TOOL_CRUD_LABEL_DESCRIPTION", "Create, read, update, or delete a label in a GitHub repository. Used in context of labels in relation to GitHub resources, they are organizational tags used to categorize and filter issues and pull requests. For 'get' method: if name is provided, retrieves a specific label; if name is omitted, lists all labels in the repository. The use of parameters depends on the specific method selected.")),
+// Label consolidates Create/Get/Update/Delete label operations into a single tool.
+func Label(getGQLClient GetGQLClientFn, t translations.TranslationHelperFunc) (mcp.Tool, server.ToolHandlerFunc) {
+	return mcp.NewTool("label",
+			mcp.WithDescription(t("TOOL_LABEL_DESCRIPTION", "Create, read, update, or delete repository labels in GitHub. Labels are organizational tags used to categorize and filter issues and pull requests. METHODS: 'create', 'get' - if label parameter name is omitted, lists all labels, 'update', 'delete'.")),
 			mcp.WithToolAnnotation(mcp.ToolAnnotation{
-				Title:        t("TOOL_CRUD_LABEL_TITLE", "CRUD label"),
+				Title:        t("TOOL_LABEL_TITLE", "Manage label operations - create, read, update, delete"),
 				ReadOnlyHint: ToBoolPtr(false),
 			}),
 			mcp.WithString("method",
 				mcp.Required(),
-				mcp.Description("Operation to perform: create, get, update or delete"),
+				mcp.Description("Create/Read/Update/Delete a github label."),
 				mcp.Enum("create", "get", "update", "delete"),
 			),
 			mcp.WithString("owner",
-				mcp.Description("Repository owner"),
+				mcp.Description("Repository owner (username or organization name) - required for all operations"),
 			),
 			mcp.WithString("repo",
-				mcp.Description("Repository name"),
+				mcp.Description("Repository name - required for all operations"),
 			),
 			mcp.WithString("name",
-				mcp.Description("Label name (for get/update/delete or to create with this name). For 'get' method: optional - if provided, gets specific label; if omitted, lists all labels."),
+				mcp.Description("Label name. REQUIRED for: create, update, delete operations. OPTIONAL for: get operation (if omitted, lists all repository labels; if provided, gets specific label details)."),
 			),
 			mcp.WithString("new_name",
-				mcp.Description("New name for the label (update only)"),
+				mcp.Description("New name for the label (used only with 'update' method to rename a label)"),
 			),
 			mcp.WithString("color",
-				mcp.Description("Label color as a 6-character hex code without '#', e.g. 'f29513' (create/update)"),
+				mcp.Description("Label color as 6-character hex code without '#' prefix, e.g. 'f29513' for orange. REQUIRED for 'create', OPTIONAL for 'update'."),
 			),
 			mcp.WithString("description",
-				mcp.Description("Label description (create/update)"),
+				mcp.Description("Label description text. OPTIONAL for both 'create' and 'update' operations."),
 			),
 		),
 		func(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
@@ -2108,30 +2108,30 @@ func CRUDLabel(getGQLClient GetGQLClientFn, t translations.TranslationHelperFunc
 // IssueLabel manages labels on GitHub issues with list, add, and remove operations.
 func IssueLabel(getClient GetClientFn, t translations.TranslationHelperFunc) (mcp.Tool, server.ToolHandlerFunc) {
 	return mcp.NewTool("issue_label",
-			mcp.WithDescription(t("TOOL_ISSUE_LABEL_DESCRIPTION", "Manage labels on GitHub issues. Use 'list' to get current labels on an issue, 'add' to add labels to an issue, or 'remove' to remove labels from an issue.")),
+			mcp.WithDescription(t("TOOL_ISSUE_LABEL_DESCRIPTION", "Manage labels attached to specific GitHub issues. METHODS: 'list', 'add', 'remove'.")),
 			mcp.WithToolAnnotation(mcp.ToolAnnotation{
-				Title:        t("TOOL_ISSUE_LABEL_TITLE", "Manage issue labels"),
+				Title:        t("TOOL_ISSUE_LABEL_TITLE", "Manage issue labels - list, add, remove"),
 				ReadOnlyHint: ToBoolPtr(false),
 			}),
 			mcp.WithString("method",
 				mcp.Required(),
-				mcp.Description("Operation to perform: list, add, or remove"),
+				mcp.Description("Operation to perform: 'list' (show current labels), 'add' (attach labels), 'remove' (detach labels)"),
 				mcp.Enum("list", "add", "remove"),
 			),
 			mcp.WithString("owner",
 				mcp.Required(),
-				mcp.Description("Repository owner"),
+				mcp.Description("Repository owner (username or organization name) - required for all operations"),
 			),
 			mcp.WithString("repo",
 				mcp.Required(),
-				mcp.Description("Repository name"),
+				mcp.Description("Repository name - required for all operations"),
 			),
 			mcp.WithNumber("issue_number",
 				mcp.Required(),
-				mcp.Description("Issue number"),
+				mcp.Description("Issue number - required for all operations to identify the specific issue"),
 			),
 			mcp.WithArray("labels",
-				mcp.Description("Label names for add/remove operations (not used for list)"),
+				mcp.Description("Array of label names to add or remove. REQUIRED for 'add' and 'remove' operations, IGNORED for 'list' operation."),
 				mcp.Items(
 					map[string]any{
 						"type": "string",