deep-research

Run long-running research tasks via OpenAI and Google Gemini Deep Research APIs.

Updated Feb 21, 2026
One-click install
npx skills add https://github.com/buddypia/kaiju-voice --skill deep-research-buddypia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deep-research
Source: https://github.com/buddypia/kaiju-voice/tree/main/.claude/skills/deep-research
Command: npx skills add https://github.com/buddypia/kaiju-voice --skill deep-research-buddypia

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openai, google-genai, pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the complex and time-consuming process of conducting in-depth research on any topic by leveraging advanced AI models from OpenAI and Google.

Core Features & Use Cases

  • Integrated Research: Seamlessly switch between OpenAI and Google Gemini Deep Research APIs.
  • Asynchronous Execution: Start long-running research tasks and poll for results later, preventing timeouts.
  • Smart Provider Selection: Automatically chooses the best AI provider based on query keywords and learned usage patterns, or allows manual strategy selection (quality, cost).
  • Robust Error Handling: Includes retry logic, fallback mechanisms, and detailed error logging for reliable operation.
  • Use Case: Research the latest trends in sustainable packaging for the European market, generating a comprehensive report with market size, key players, and regulatory impacts.

Quick Start

Use the deep research skill to start a research task on the topic of quantum computing advancements.

Frequently Asked Questions about deep-research

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate in-depth research and report generation using AI?

To automate in-depth research and report generation, this Skill uses OpenAI and Google Gemini Deep Research APIs to process queries and generate comprehensive outputs. It manages long-running tasks asynchronously so you can start a query and poll for the completed report later.

How does asynchronous execution work for long-running AI research tasks?

Asynchronous execution for AI research tasks works through a subcommand architecture with start and poll commands. This prevents timeouts on long-running tasks by allowing you to initiate the research process and check back for results once the provider has finished generating the report.

Do I need API keys for both OpenAI and Google Gemini to run deep research tasks?

Yes, you need API keys for both OpenAI and Google to run deep research tasks. The Skill requires these credentials to access the respective Deep Research APIs and execute the automated query processing and report generation workflows.

How does the system choose between OpenAI and Google Gemini for a research query?

The system chooses between OpenAI and Google Gemini using smart provider selection based on query analysis and learned usage patterns. You can also manually select a strategy prioritizing either quality or cost to force a specific provider for your research task.

What happens if an AI provider fails during the research process?

If an AI provider fails during the research process, the system uses robust error handling with retry logic and fallback mechanisms. It also provides detailed error logging to ensure reliable operation and continue your automated report generation workflow where possible.