Agent skill · research science · assafelovic
gpt-researcher
GPT Researcher is an autonomous deep research agent that conducts web and local research, producing detailed reports with citations. Use this skill when helping developers understand, extend, debug, or integrate with GPT Researcher - including adding features, understanding the architecture, working with the API, customizing research workflows, adding new retrievers, integrating MCP data sources, or troubleshooting research pipelines.
Why this skill is useful
Provides specific patterns and code snippets for integrating and extending the GPT Researcher, which the AI wouldn't reliably generate on its own.
What it needs
Requires npm, python, uvicorn installed locally. About 3k tokens when loaded. Last updated 2026-07-18. 28,863 stars on the source repository.
What this skill does
GPT Researcher Development Skill GPT Researcher is an LLM-based autonomous agent using a planner-executor-publisher pattern with parallelized agent work for speed and reliability. Quick Start Basic Python Usage Run Servers --- Key File Locations Need Primary File Key Classes ------ -------------- ------------- Main orchestrator gptresearcher/agent.py GPTResearcher Research logic gptresearcher/skills/researcher.py ResearchConductor Report writing gptresearcher/skills/writer.py ReportGenerator All prompts gptresearcher/prompts.py PromptFamily Configuration gptresearcher/config/config.py Config Config defaults gptresearcher/config/variables/default.py DEFAULTCONFIG API server backend/server/app.py FastAPI app Search engines gptresearcher/retrievers/ Various retrievers --- Architecture Overview For detailed architecture diagrams: See references/architecture.md --- Core Patterns Adding a New Feature (8-Step Pattern) 1. Config → Add to gptresearcher/config/variables/default.py 2. Provider → Create in gptresearcher/llmprovider/myfeature/ 3. Skill → Create in gptresearcher/skills/myfeature.py 4. Agent → Integrate in gptresearcher/agent.py 5. Prompts → Update gptresearcher/prompts.py 6. WebSocket → Events via streamoutput() 7. Frontend → Handle events in useWebSocket.ts 8. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills assafelovic/.claude