x-deep-research

Original：🇺🇸 English
Translated

Conduct deep research using OpenAI's deep research models via API. Use when the user asks for comprehensive analysis, company research, person research, or product research requiring web-sourced citations.

6installs
Sourcearda-industries/agent-skills
Added on

NPX Install

npx skill4agent add arda-industries/agent-skills x-deep-research

Tags

Translated version includes tags in frontmatter
deep-researchopenai-apiagent-workflowcitation-managementresearch-templates

SKILL.md Content

View Translation Comparison →

Deep Research

Conduct citation-backed research using OpenAI's deep research models.

Agent Workflow

bash
cd ~/brain/git/personal/agent-instructions
0. Ask model → 1. Submit → 2. Poll status → 3. Download → 4. Post-process

0. Ask User: Model Selection (REQUIRED)

Before submitting, ask the user which model to use:
ModelQualityCostUse When
o3-deep-researchHigher$1-3Important research, external-facing, deep analysis
o4-mini-deep-researchGood$0.20-0.60Quick lookups, internal use, cost-sensitive
Present this choice and wait for user response before proceeding.

1. Submit

bash
poetry run python scripts/deep_research.py submit \
  --template company \
  --topic "Company Name" \
  --model o3-deep-research \
  --output ~/brain/obsidian/Timatron/Raw\ Transcripts\ \&\ Research/research/
Templates: 
company
, 
person
, 
product
, 
custom
(use 
--query
for custom) Models: 
o3-deep-research
(default), 
o4-mini-deep-research

2. Poll Status

bash
poetry run python scripts/deep_research.py status <response_id>
Research takes 5-30 minutes. Poll every few minutes until 
completed
.

3. Download

bash
poetry run python scripts/deep_research.py download <response_id> \
  --output ~/brain/obsidian/Timatron/Raw\ Transcripts\ \&\ Research/research/
Report usage stats to user (shown after download):
  • Model, duration, token counts, cost

4. Post-Process Citations (REQUIRED)

After downloading, edit the report to convert parenthetical citations to inline links:
Before: 
The company raised $100M ([source.com](url)).
After: 
The company [raised $100M](url).
Also consolidate duplicate citations — one link per fact is sufficient.

API Key Setup

Edit 
~/.config/openai/profiles.json
:
json
{
  "default": "personal",
  "profiles": {
    "personal": {
      "api_key": "sk-proj-YOUR-KEY-HERE"
    }
  }
}
Use 
--profile <name>
to select a profile. Falls back to 
OPENAI_API_KEY
env var.

Pricing Reference

ModelInput/M tokensOutput/M tokens
o3-deep-research$10.00$40.00
o4-mini-deep-research$2.00$8.00
Typical query uses 50-100K tokens. Exact cost reported after download.

Prompt Templates

Located in 
prompts/
:
  • base.md
    — Common instructions (word limits, citation style, format rules)
  • company.md
    — Company research structure
  • person.md
    — Person research structure
  • product.md
    — Product research structure

Troubleshooting