diff --git a/lib/schemas/src/plugins/cloudsmith.ts b/lib/schemas/src/plugins/cloudsmith.ts
index fd4cb4894..20791837b 100644
--- a/lib/schemas/src/plugins/cloudsmith.ts
+++ b/lib/schemas/src/plugins/cloudsmith.ts
@@ -1,5 +1,10 @@
 import { z } from 'zod'
 
 export const CloudsmithSchema = z.object({
-  serviceAccount: z.string().optional().describe('the Cloudsmith service account')
+  serviceAccount: z
+    .string()
+    .optional()
+    .describe(
+      'the Cloudsmith service account. this will probably be your team name followed by the permissions access, e.g., cp-reliability-read-write.'
+    )
 })