research

name	research
cluster	research-knowledge
version	1.0.0
description	Comprehensive research, analysis, and content extraction system. USE WHEN user says 'do research', 'do extensive research', 'quick research', 'minor research', 'research this', 'find information', 'investigate', 'extract wisdom', 'extract alpha', 'analyze content', 'can\'t get this content', 'use fabric', OR requests any web/content research. Supports three research modes (quick/standard/extensive), deep content analysis, intelligent retrieval, and 242+ Fabric patterns. NOTE: For due diligence, OSINT, or background checks, use OSINT skill instead.
implements	Science
science_cycle_time	meso
context	fork

Customization

Before executing, check for user customizations at: ~/.Codex/skills/CORE/USER/SKILLCUSTOMIZATIONS/Research/

If this directory exists, load and apply any PREFERENCES.md, configurations, or resources found there. These override default behavior. If the directory does not exist, proceed with skill defaults.

Research Skill

Comprehensive research, analysis, and content extraction system.

MANDATORY: URL Verification

READ: UrlVerificationProtocol.md - Every URL must be verified before delivery.

Research agents hallucinate URLs. A single broken link is a catastrophic failure.

---

Voice Notification

When executing a workflow, do BOTH:

1. Send voice notification:

   curl -s -X POST http://localhost:8888/notify \
     -H "Content-Type: application/json" \
     -d '{"message": "Running the WORKFLOWNAME workflow from the Research skill"}' \
     > /dev/null 2>&1 &
   

2. Output text notification:

   Running the **WorkflowName** workflow from the **Research** skill...
   

Full documentation: ~/.Codex/skills/CORE/SYSTEM/THENOTIFICATIONSYSTEM.md

Workflow Routing

Route to the appropriate workflow based on the request.

CRITICAL: For due diligence, company/person background checks, or vetting -> INVOKE OSINT SKILL INSTEAD

Research Modes (Primary Workflows)

• Quick/minor research (1 Codex, 1 query) -> Workflows/QuickResearch.md
• Standard research - DEFAULT (2 agents: Codex + Gemini) -> Workflows/StandardResearch.md
• Extensive research (3 types x 3 threads = 9 agents) -> Workflows/ExtensiveResearch.md

Deep Content Analysis

• Extract alpha / deep analysis / highest-alpha insights -> Workflows/ExtractAlpha.md

Content Retrieval

• Difficulty accessing content (CAPTCHA, bot detection, blocking) -> Workflows/Retrieve.md
• YouTube URL extraction (use fabric -y URL immediately) -> Workflows/YoutubeExtraction.md
• Web scraping -> Workflows/WebScraping.md

Specific Research Types

• Codex WebSearch only (free, no API keys) -> Workflows/ClaudeResearch.md
• Interview preparation (Tyler Cowen style) -> Workflows/InterviewResearch.md
• AI trends analysis -> Workflows/AnalyzeAiTrends.md

Fabric Pattern Processing

• Use Fabric patterns (242+ specialized prompts) -> Workflows/Fabric.md

Content Enhancement

• Enhance/improve content -> Workflows/Enhance.md
• Extract knowledge from content -> Workflows/ExtractKnowledge.md

---

Quick Reference

READ: QuickReference.md for detailed examples and mode comparison.

Trigger	Mode	Speed
"quick research"	1 Codex agent	~10-15s
"do research"	2 agents (default)	~15-30s
"extensive research"	9 agents	~60-90s

---

Integration

Feeds Into

• blogging - Research for blog posts
• newsletter - Research for newsletters
• xpost - Create posts from research

Uses

• be-creative - deep thinking for extract alpha
• OSINT - MANDATORY for company/people comprehensive research
• BrightData MCP - CAPTCHA solving, advanced scraping
• Apify MCP - RAG browser, specialized site scrapers

---

File Organization

Scratch (temporary work artifacts): ~/.Codex/MEMORY/WORK/{current_work}/scratch/

• Read ~/.Codex/MEMORY/STATE/current-work.json to get the work_dir value
• All iterative work artifacts go in the current work item's scratch/ subdirectory
• This ties research artifacts to the work item for learning and context

History (permanent): ~/.Codex/History/research/YYYY-MM/YYYY-MM-DD_[topic]/