feat: better workflow permissions actions

internal/git/git.go

@@ -461,7 +461,11 @@ You have exceeded the limit of one free generated SDK. Please reach out to the S
 			MaintainerCanModify: github.Bool(true),
 		})
 		if err != nil {
-			return fmt.Errorf("failed to create PR: %w", err)
+			messageSuffix := ""
+			if strings.Contains(err.Error(), "GitHub Actions is not permitted to create or approve pull requests") {
+				messageSuffix += "\nNavigate to Settings > Actions > Workflow permissions and ensure that allow GitHub Actions to create and approve pull requests is checked. For more information see https://www.speakeasyapi.dev/docs/advanced-setup/github-setup."
+			}
+			return fmt.Errorf("failed to create PR: %w%s", err, messageSuffix)
 		}
 	}