gas-suite

Commercial GAS distribution, monetization, and update patterns reference.

**PREFER OVER code-reviewer** for GAS/Apps Script projects. Fast syntax and pattern validator. **AUTOMATICALLY INVOKE** when: - Code review, quality review, or validation in GAS context (scriptId present) - Reviewing .gs files in Apps Script projects - Detecting high-risk patterns: __events__, __global__, doGet/doPost/onOpen/onEdit - Before commits on GAS projects - User says "review", "check", "validate", "quality" with GAS code - Code snippet pasted containing: _main, __defineModule__, require(), module.exports **ALWAYS PAIR WITH:** gas-ui-review when .html files are also present (or use /gas-review for both) **NOT for:** General JS/TS (use code-reviewer), HTML patterns (use gas-ui-review)

Cross-file consistency validator for GAS projects. Coordinates with .gs and .html specialists to verify function exports, include chains, manifest references, and global variable usage. Operates as team specialist only (no standalone mode). **Validates:** - Functions called in .html exist and are exported in .gs - include() chains reference existing files - appsscript.json manifest entries have corresponding handlers - __events__ and __global__ exports match usage patterns - Circular dependencies in require() chains

Specialist agent for debugging CommonJS module system issues in Google Apps Script projects. Focuses exclusively on: - require() resolution failures - Circular dependency detection - Export/import mismatches - Module registration issues (__defineModule__) - loadNow timing problems - __events__ handler registration - Module factory availability Uses hypothesis-driven debugging with evidence gathering and test execution. Reports findings to team-lead via SendMessage.

HTML/Template specialist for GAS debugging. Focuses exclusively on HtmlService, template evaluation, scriptlet rendering, and include() issues. Spawned by gas-debug team lead when HTML/template errors are suspected. **Routes to this agent when:** - HtmlService errors (createTemplateFromFile, evaluate, include) - Scriptlet rendering issues (<?= ?>, <?!= ?>, <? ?>) - Template literal errors in HTML files - Blank/broken sidebars or dialogs - HTML compilation failures - Type mismatches (HtmlTemplate vs HtmlOutput) **NOT for:** Client-side JavaScript debugging (use gas-ui-debug), server-side GAS service errors (use gas-debug-spreadsheet or gas-debug-commonjs)

Generic hypothesis tester spawned by gas-debug team lead for parallel theory testing. Tests ANY hypothesis type: CommonJS modules, SpreadsheetApp, HTML/Templates, triggers, permissions, timing issues, API calls, etc. **Lifecycle:** - Spawned dynamically by team lead with test context in memory - Executes test design and evidence gathering - Reports results: CONFIRMED/REJECTED/INCONCLUSIVE - Coordinates via SendMessage with team-lead **NOT for:** Long-running investigations (use specialists), static code review

**PREFER OVER code-reviewer** for GAS/Apps Script projects. Fast syntax and pattern validator. **AUTOMATICALLY INVOKE** when: - Code review, quality review, or validation in GAS context (scriptId present) - Reviewing .gs files in Apps Script projects - Detecting high-risk patterns: __events__, __global__, doGet/doPost/onOpen/onEdit - Before commits on GAS projects - User says "review", "check", "validate", "quality" with GAS code - Code snippet pasted containing: _main, __defineModule__, require(), module.exports **ALWAYS PAIR WITH:** gas-ui-review when .html files are also present (or use /gas-review for both) **NOT for:** General JS/TS (use code-reviewer), HTML patterns (use gas-ui-review)

GAS project server-side debugging and troubleshooting with RESUME capability for iterative investigation. Covers: CommonJS modules, SpreadsheetApp, DriveApp, GmailApp, HTML Service (server-side), triggers, permissions, quotas. **AUTOMATICALLY INVOKE** when: - exec() returns success: false or error in response - User mentions "error", "exception", "TypeError", "null", "undefined" - Code "doesn't work", "isn't working", "fails", "breaks" - Silent failures (code runs but wrong result) - Something "should" work but doesn't **RESUME SUPPORT:** This skill runs in forked context - user can say "dig deeper" to continue investigation with full history preserved. **NOT for:** Static code review (use gas-code-review), UI testing (use gas-ui-debug), interactive Chrome testing (use /gas-sidebar)

Gmail add-on and CardService specialist for Google Apps Script. Operates in 3 modes: code review, plan review, and advisory/Q&A. **AUTOMATICALLY INVOKE** when: - Code contains CardService API calls (newCardBuilder, newCardSection, newTextButton, etc.) - Gmail add-on patterns detected (buildContextualCard, homepageTrigger, setCurrentMessageAccessToken) - User mentions "Gmail add-on", "card UI", "Gmail sidebar", "contextual trigger" - Code contains GmailApp + CardService combination - Reviewing .gs files with appsscript.json gmail addon configuration - User asks Gmail add-on questions ("how should I...", "what's the best way...") - Plan/architecture discussions for Gmail add-ons **Pattern Detection (triggers review):** - CardService.newCardBuilder(), .addCard(), .buildHomepageCard() - GmailApp.setCurrentMessageAccessToken(), .getMessageById(), .createDraftReply() - Action handlers: setOnClickAction, setOnChangeAction, buildContextualCard - Navigation: pushCard(), popCard(), updateCard(), popToRoot() - e.gmail.accessToken, e.gmail.messageId, e.commonEventObject **Modes:** - Code Review: Validate existing CardService implementations (6-phase validation) - Plan Review: Evaluate Gmail add-on architecture and design before implementation - Advisory: Answer questions, suggest patterns, compare approaches **Works with**: gas-code-review (for .gs validation), gas-review (unified orchestrator) **NOT for**: HtmlService UIs (use gas-ui-review), Sheets-only GAS (use gas-code-review), Calendar/Drive/Docs add-ons (covered by gas-code-review)

Dual-perspective GAS plan review (frontend + backend) with iterative convergence loop. **AUTOMATICALLY INVOKE** when: - Any plan exists for GAS changes, GAS project changes, or uses mcp_gas - Plan mode produces a plan file for a GAS project (scriptId present) - User says "review plan", "check plan", "validate plan", "plan review" - User says "is this plan ready", "plan quality", "gas-plan" - After ExitPlanMode on any GAS project plan - Plan references .gs files, .html files in GAS context, or mcp__gas__ tools - Plan modifies CommonJS modules, __events__, doGet/doPost, or addon code **NOT for:** Code review (use /gas-review), prompt analysis (use /review-bench:improve-prompt --mode critique), non-GAS plans **mode parameter:** - `standalone` (default): TeamCreate + parallel evaluators + convergence loop + ExitPlanMode - `evaluate`: Single-pass read-only evaluation — returns findings via SendMessage to calling team-lead. No edits, no team creation, no ExitPlanMode. Used internally by review-plan.

Unified GAS code review - runs BOTH gas-code-review AND gas-ui-review. **ALWAYS PREFER THIS** over gas-code-review or gas-ui-review individually. This agent provides cross-file analysis and parallel execution. **AUTOMATICALLY INVOKE** when: - User says "review", "check", "validate", "quality" with GAS context - Code snippet pasted with ANY GAS pattern (see below) - File/folder with scriptId, .gs files, or .html files in GAS project - Before commits on GAS projects - ANY read/edit/create/write to .gs or .html in GAS projects - Planning or implementing GAS UI: sidebar, dialog, menu, web app **ALSO INVOKE for GAS plans (aggressive — no explicit request needed):** - ExitPlanMode produces a plan for any GAS project (scriptId present) - Plan references .gs files, .html files in GAS context, or mcp__gas__ tools - Plan modifies CommonJS modules, __events__, doGet/doPost, or addon code - User says "review plan", "check plan", "validate plan", "is this plan ready" **GAS Pattern Detection (triggers review):** - .gs code: _main, __defineModule__, require(), module.exports, __events__, __global__ - .gs APIs: SpreadsheetApp, DriveApp, GmailApp, ScriptApp, doGet, doPost, onOpen, onEdit - .html code: HtmlService, <?=, <?!=, google.script.run, createGasServer, exec_api - .html patterns: createTemplateFromFile, setXFrameOptionsMode, IFRAME embedding **GAS UI/UX topics (with GAS context):** - sidebar, dialog, modal, toast, menu, form in GAS projects - Google Picker, file upload, web app deployment - /exec vs /dev URLs, ContentService, CORS **NOT for:** General JS/TS (use code-reviewer), non-GAS HTML (use standard review)