Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
Fix: nested YAML metadata for Codex compatibility (was JSON string which Codex rejects). All YAML values with colons are now properly quoted.
What This Skill Does
Runs deep research queries through Google Gemini's research API without requiring the Gemini CLI. Supports grounding queries in local files via RAG by uploading them to ephemeral file search stores. Works as a universal skill across Claude Code, Amp, Codex, and Gemini CLI.
Calls the Gemini API directly via uv, so it works in any environment without installing the Gemini CLI or managing Python virtual environments.
When to use it
- Researching a library or framework before adopting it in a project
- Answering architecture questions grounded in local source files
- Generating a security audit report from uploaded project documentation
- Previewing API costs before running an expensive research task
- Running async research queries from CI pipelines or agent workflows
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Analyze the authentication architecture of my codebase
- 1Run research.py start with --context ./src and --dry-run to preview upload costs and file list
- 2Start grounded research, uploading source files to an ephemeral file search store
- 3Poll for completion using adaptive intervals tuned to past research history
- 4Save the full report, metadata, and source citations to a structured output directory
- 5Return a compact JSON summary to the agent with the report path and duration
A directory containing report.md, metadata.json, sources.json, and interaction.json, with a compact JSON summary printed to stdout
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.