deep-research

Run OpenAI Deep Research API workflows with prompt enhancement and source collection.

46|14|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/alexdcd/Mafia-Claude-Skills --skill deep-research-alexdcd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deep-research
Source: https://github.com/alexdcd/Mafia-Claude-Skills/tree/main/skills/deep-research
Command: npx skills add https://github.com/alexdcd/Mafia-Claude-Skills --skill deep-research-alexdcd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openai, and includes scripts (resource) and assets (resource) and references (resource) components.

What problem does it solve?

This skill enables comprehensive, internet-enabled research by orchestrating prompt enhancement, parameter saving, and execution of deep research via the OpenAI API. It helps users obtain structured insights with traceable sources.

Core Features & Use Cases

  • Smart prompt enhancement: detects brief or generic prompts and interactively refines them with 2-3 targeted questions (technical or general, depending on input).
  • Reproducibility: saves enhanced prompts and parameters to timestamped files for audit trails and repeatability.
  • End-to-end execution: runs the deep research workflow, including web search, result compilation, and source extraction.
  • Use cases: in-depth market analysis, competitive landscape studies, or any topic requiring web-backed reasoning.

Quick Start

Run the orchestration script to refine your prompt, then launch the deep research process.

Frequently Asked Questions about deep-research

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

FAQPage Schema
How do I automate reproducible internet research using OpenAI?

Reproducible internet research uses OpenAI's Deep Research API to generate structured insights with traceable sources. The workflow orchestrates prompt enhancement and saves parameters to timestamped files for audit trails and repeatability.

Do I need an OpenAI API key to run deep research scripts?

Yes, an OpenAI API key is required to run deep research scripts. You also need a local environment to execute the orchestration script and a configured model, defaulting to o4-mini-deep-research, to perform the web-backed reasoning.

How does prompt enhancement work for web search queries?

Prompt enhancement detects brief or generic inputs and interactively refines them by asking 2-3 targeted questions. This ensures the web search queries are comprehensive enough to yield structured insights before execution.

Can I use this for market analysis and competitive landscape studies?

Yes, this deep research skill is designed for in-depth market analysis and competitive landscape studies. It applies web-backed reasoning to compile results and extract sources across general and technical domains.

What is the best way to save research parameters for audit trails?

The best way to save research parameters for audit trails is using the built-in reproducibility feature. It automatically saves enhanced prompts and execution parameters to timestamped files locally for repeatability.