Agent Deep Research
Async deep research via Gemini Interactions API. RAG-ground queries on local files, preview costs with --dry-run, get structured JSON output. Universal skill for 30+ AI agents.
Install on your platform
We auto-selected Claude Code based on this skill’s supported platforms.
Run in terminal (recommended)
claude mcp add agent-deep-research npx -- -y @trustedskills/agent-deep-research
Or manually add to ~/.claude/settings.json
{
"mcpServers": {
"agent-deep-research": {
"command": "npx",
"args": [
"-y",
"@trustedskills/agent-deep-research"
]
}
}
}Requires Claude Code (claude CLI). Run claude --version to verify your install.
About This Skill
What it does
This skill enables deep research and retrieval-augmented generation (RAG) capabilities within AI agents. It leverages the Google Gemini Interactions API to search files and provide grounded responses, integrating seamlessly with a wide range of agent platforms. The skill utilizes the google-genai Python SDK directly via uv run, eliminating the need for the Gemini CLI.
When to use it
- Complex Research Tasks: When an agent needs to gather information from multiple files and synthesize a comprehensive answer, such as researching competitor strategies or summarizing legal documents.
- File-Based Knowledge Base: To enable agents to access and utilize specific data stored in files, like product documentation or internal reports.
- Code Understanding & Assistance: Help an agent understand and debug code by searching relevant files within a project repository.
- Automated Report Generation: Generate reports based on information extracted from various documents.
Key capabilities
- Google Gemini Interactions API integration
- Retrieval-Augmented Generation (RAG)
- File search functionality
- Compatibility with Claude Code, Amp, Codex, OpenCode, Cursor, Gemini CLI, Pi, and 30+ other agents.
- Direct use of
google-genaiPython SDK
Example prompts
- "Research the latest trends in sustainable energy and summarize your findings."
- "Find all files related to 'Project Phoenix' and create a brief overview."
- "What are the key differences between these two code snippets, based on available documentation?"
Tips & gotchas
- A Google API key is required for this skill. Ensure you have configured either
GEMINI_DEEP_RESEARCH_API_KEY,GOOGLE_API_KEY, orGEMINI_API_KEYenvironment variable. - The skill relies on
uv; ensure it's installed correctly before attempting to use the skill.
Requirements
TrustedSkills Verification
Unlike other registries that point to live repositories, TrustedSkills pins every skill to a verified commit hash. This protects you from malicious updates — what you install today is exactly what was reviewed and verified.
Installing this skill downloads the exact code at commit 1b90f0df, not the current state of the repository. This prevents supply-chain attacks from unauthorized updates.
Security Audits
| Gen Agent Trust Hub | Pass |
| Socket | Pass |
| Snyk | Pass |
🌐 Community
Passed automated security scans.
Install command fetches the verified snapshot, not the live repository.