Default output: return only the result, blockers, and required evidence. Omit preambles, process narration, repeated context, confidence scores, and follow-up offers. Use at most five bullets unless a required artifact or schema needs more.
Gemini Agent SDK / Gemini Workflow Adapter
Use this skill when implementing a Gemini-backed runner for a workflow that also exists for Cursor, OpenCode, Claude, or OpenAI. This repo currently packages Gemini CLI skills/commands, so a Gemini workflow adapter should be added deliberately and kept compatible with the shared workflow contract.
Local references
docs/gemini-cli-setup.mddocuments current Gemini CLI packaging.agents/research-runner/shows the multi-runtime runner pattern to mirror.agents/research-runner/shared/should hold reusable prompts, templates, and output code.
Workflow adapter contract
Shared types: agents/research-runner/shared/workflow-contract.ts (WorkflowInput, WorkflowResult, optional safetyNotes).
No Gemini runner exists yet. Add agents/research-runner/gemini/runner.ts (or a new workflow folder) implementing this contract; keep .gemini/skills as CLI distribution only.
Implementation rules
- Use official Gemini docs for current SDK names and APIs. Do not rely on memory for package names, auth, tool-calling, or streaming semantics.
- Mirror the existing runner layout. Add
agents/<workflow>/gemini/runner.tsor equivalent beside the other harness variants. - Keep CLI packaging separate.
.gemini/skillsand.gemini/commandsare distribution assets; SDK workflow runners are executable code. - Use structured responses for machine decisions. Parse JSON for handoffs, verdicts, and next actions.
- Treat safety blocks as workflow states. Return
blockedwith the exact model/safety reason instead of retrying blindly. - Verify claims outside the model. File checks, git checks, and test commands belong to deterministic runner code.
- Keep prompts shared. Only put Gemini-specific prompt adaptations in the Gemini adapter.
Good fits
- Research and synthesis variants
- Provider comparison workflows
- Workflows where Gemini is selected by model policy
Poor fits
- Repo mutation without a local verification harness
- Assuming Gemini CLI skills are the same thing as a Gemini SDK runner