1# Learn a new concept | Codex use cases1---
2name: Learn a new concept
3tagline: Turn dense source material into a clear, reviewable learning report.
4summary: Use ChatGPT to study material such as research papers or courses, split
5 the reading across subagents, gather context, and produce a Markdown report
6 with diagrams.
7skills:
8 - token: $imagegen
9 description: Generate illustrative, non-exact visual assets when a Mermaid
10 diagram is not enough.
11bestFor:
12 - Individuals learning about an unfamiliar concept
13 - Dense source material that benefits from parallel reading, context
14 gathering, diagrams, and a written synthesis
15 - Turning a one-off reading session into a reusable Markdown report with
16 citations, glossary terms
17starterPrompt:
18 title: Analyze a Research Paper and Teach Me the Concept
19 body: >-
20 I want to learn a new concept from this research paper: [paper path or URL].
2 21
3Codex use cases
4 22
523 Please run this as a subagent workflow:
6 24
725 - Spawn one subagent to map the paper's problem statement, contribution,
26 method, experiments, and limitations.
8 27
9Codex use case28 - Spawn one subagent to gather prerequisite context and explain the
29 background terms I need.
10 30
11# Learn a new concept31 - Spawn one subagent to inspect the figures, tables, notation, and any
32 claims that need careful verification.
12 33
13Turn dense source material into a clear, reviewable learning report.34 - Wait for all subagents, reconcile disagreements, and avoid overclaiming
35 beyond the source material.
14 36
15Difficulty **Intermediate**
16 37
17Time horizon **30m**38 Final output:
18 39
19Use Codex to study material such as research papers or courses, split the reading across subagents, gather context, and produce a Markdown report with diagrams.40 - create `notes/[concept-name]-report.md`
20 41
21## Best for42 - include an executive summary, glossary, paper walkthrough, concept map,
43 method diagram, evidence table, caveats, and open questions
22 44
23- Individuals learning about an unfamiliar concept45 - use Markdown-native Mermaid diagrams where diagrams help
24- Dense source material that benefits from parallel reading, context gathering, diagrams, and a written synthesis
25- Turning a one-off reading session into a reusable Markdown report with citations, glossary terms
26 46
27# Contents47 - use imagegen to generate illustrative, non-exact visual assets when a
48 Markdown-native diagram is not enough
28 49
29[← All use cases](https://developers.openai.com/codex/use-cases)50 - cite paper sections, pages, figures, or tables whenever possible
30 51
31Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/learn-a-new-concept/?export=pdf)
32 52
33Use Codex to study material such as research papers or courses, split the reading across subagents, gather context, and produce a Markdown report with diagrams.53 Constraints:
34 54
35Intermediate55 - do not treat the paper as ground truth if the evidence is weak
36 56
3730m57 - separate what the paper claims from your interpretation
38 58
39Related links59 - call out missing background, assumptions, and follow-up reading
40 60relatedLinks:
41[Subagents](https://developers.openai.com/codex/subagents) [Subagent concepts](https://developers.openai.com/codex/concepts/subagents)61 - label: Subagents
42 62 url: /codex/agent-configuration/subagents
43## Best for63---
44
45- Individuals learning about an unfamiliar concept
46- Dense source material that benefits from parallel reading, context gathering, diagrams, and a written synthesis
47- Turning a one-off reading session into a reusable Markdown report with citations, glossary terms
48
49## Skills & Plugins
50
51- ImageGen
52
53 Generate illustrative, non-exact visual assets when a Mermaid diagram is not enough.
54
55| Skill | Why use it |
56| --- | --- |
57| ImageGen | Generate illustrative, non-exact visual assets when a Mermaid diagram is not enough. |
58
59## Starter prompt
60
61I want to learn a new concept from this research paper: [paper path or URL].
62Please run this as a subagent workflow:
63- Spawn one subagent to map the paper's problem statement, contribution, method, experiments, and limitations.
64- Spawn one subagent to gather prerequisite context and explain the background terms I need.
65- Spawn one subagent to inspect the figures, tables, notation, and any claims that need careful verification.
66- Wait for all subagents, reconcile disagreements, and avoid overclaiming beyond the source material.
67Final output:
68- create `notes/[concept-name]-report.md`
69- include an executive summary, glossary, paper walkthrough, concept map, method diagram, evidence table, caveats, and open questions
70- use Markdown-native Mermaid diagrams where diagrams help
71- use imagegen to generate illustrative, non-exact visual assets when a Markdown-native diagram is not enough
72- cite paper sections, pages, figures, or tables whenever possible
73Constraints:
74- do not treat the paper as ground truth if the evidence is weak
75- separate what the paper claims from your interpretation
76- call out missing background, assumptions, and follow-up reading
77
78Open in the Codex app
79
80I want to learn a new concept from this research paper: [paper path or URL].
81Please run this as a subagent workflow:
82- Spawn one subagent to map the paper's problem statement, contribution, method, experiments, and limitations.
83- Spawn one subagent to gather prerequisite context and explain the background terms I need.
84- Spawn one subagent to inspect the figures, tables, notation, and any claims that need careful verification.
85- Wait for all subagents, reconcile disagreements, and avoid overclaiming beyond the source material.
86Final output:
87- create `notes/[concept-name]-report.md`
88- include an executive summary, glossary, paper walkthrough, concept map, method diagram, evidence table, caveats, and open questions
89- use Markdown-native Mermaid diagrams where diagrams help
90- use imagegen to generate illustrative, non-exact visual assets when a Markdown-native diagram is not enough
91- cite paper sections, pages, figures, or tables whenever possible
92Constraints:
93- do not treat the paper as ground truth if the evidence is weak
94- separate what the paper claims from your interpretation
95- call out missing background, assumptions, and follow-up reading
96 64
97## Introduction65## Introduction
98 66
99Learning a new concept from a dense paper or course requires more than just summarization. The goal is to build a working mental model: what problem it addresses, what the method actually does, which evidence supports it, what assumptions it depends on, and which parts you still need to investigate.67Learning a new concept from a dense paper or course requires more than just summarization. The goal is to build a working mental model: what problem it addresses, what the method actually does, which evidence supports it, what assumptions it depends on, and which parts you still need to investigate.
100 68
101Codex is useful here because it can automate the context gathering, and can turn complicated concepts into helpful diagrams or illustrations. This use case is also a good fit for [subagents](https://developers.openai.com/codex/concepts/subagents): one thread can read the paper for structure, another can gather prerequisite context, another can inspect figures and notation, and the main thread can reconcile the results into a report you can review later.69ChatGPT is useful here because it can automate the context gathering, and can turn complicated concepts into helpful diagrams or illustrations. This use case is also a good fit for [subagents](https://developers.openai.com/codex/agent-configuration/subagents): one thread can read the paper for structure, another can gather prerequisite context, another can inspect figures and notation, and the main thread can reconcile the results into a report you can review later.
102 70
103For this use case, the final artifact should be something you can easily review: a Markdown file such as `notes/concept-report.md`, or a document of another format. It should include a summary, glossary, walkthrough, diagrams, evidence table, limitations, and open questions instead of ending with a transient chat answer.71For this use case, the final artifact should be something you can easily review: a Markdown file such as `notes/concept-report.md`, or a document of another format. It should include a summary, glossary, walkthrough, diagrams, evidence table, limitations, and open questions instead of ending with a transient chat answer.
104 72
110 78
111> I want to understand the main idea in this research paper, how the method works, why the experiments support or do not support the claim, and what I should read next.79> I want to understand the main idea in this research paper, how the method works, why the experiments support or do not support the claim, and what I should read next.
112 80
113That scope gives Codex a concrete job. It should teach you the concept, but it should also preserve uncertainty, cite where claims came from, and separate the paper’s claims from its own interpretation.81That scope gives ChatGPT a concrete job. It should teach you the concept, but it should also preserve uncertainty, cite where claims came from, and separate the paper's claims from its own interpretation.
114 82
115## Running example: research paper analysis83## Running example: research paper analysis
116 84
128 96
129## Split the work across subagents97## Split the work across subagents
130 98
131Subagents work best when each one has a bounded job and a clear return format. Ask Codex to spawn them explicitly; Codex does not need to use subagents for every reading task, but parallel exploration helps when the paper is long or conceptually dense.99Subagents work best when each one has a bounded job and a clear return format. Ask ChatGPT to spawn them explicitly; ChatGPT does not need to use subagents for every reading task, but parallel exploration helps when the paper is long or conceptually dense.
132 100
133For a research paper, a practical split is:101For a research paper, a practical split is:
134 102
137- **Notation and figures:** Walk through equations, algorithms, diagrams, figures, and tables.105- **Notation and figures:** Walk through equations, algorithms, diagrams, figures, and tables.
138- **Skeptical reviewer:** Check whether the evidence supports the claims, list caveats, and identify missing baselines or unclear assumptions.106- **Skeptical reviewer:** Check whether the evidence supports the claims, list caveats, and identify missing baselines or unclear assumptions.
139 107
140The main agent should wait for those subagents, compare their answers, and resolve contradictions. Codex will then synthesize the results into a coherent report.108The main agent should wait for those subagents, compare their answers, and resolve contradictions. ChatGPT will then synthesize the results into a coherent report.
141 109
142## Gather additional context deliberately110## Gather additional context deliberately
143 111
144When the paper assumes background you do not have, ask Codex to gather context from approved sources. That might mean local notes, a bibliography folder, linked papers, web search if enabled, or a connected knowledge base.112When the paper assumes background you do not have, ask ChatGPT to gather context from approved sources. That might mean local notes, a bibliography folder, linked papers, web search if enabled, or a connected knowledge base.
145 113
146If you’re learning about an internal concept, you can connect multiple sources with [plugins](https://developers.openai.com/codex/plugins) to create a knowledge base.114If you're learning about an internal concept, you can connect multiple sources with [plugins](https://developers.openai.com/codex/plugins) to create a knowledge base.
147 115
148Keep this step bounded. Tell Codex what counts as a reliable source and what the final report should do with external context:116Keep this step bounded. Tell ChatGPT what counts as a reliable source and what the final report should do with external context:
149 117
150- Define prerequisite terms in a glossary.118- Define prerequisite terms in a glossary.
151- Add a short “background you need first” section.119- Add a short "background you need first" section.
152- Link follow-up readings separately from the paper’s own claims.120- Link follow-up readings separately from the paper's own claims.
153- Mark claims that come from outside the paper.121- Mark claims that come from outside the paper.
154 122
155## Generate diagrams for the report123## Generate diagrams for the report
156 124
157Diagrams are often the fastest way to check whether you really understand a concept. For a Markdown report, ask Codex for diagrams that stay close to the source material and are easy to revise.125Diagrams are often the fastest way to check whether you really understand a concept. For a Markdown report, ask ChatGPT for diagrams that stay close to the source material and are easy to revise.
158 126
159Good defaults include:127Good defaults include:
160 128
163- An experiment map that connects datasets, metrics, baselines, and reported claims.131- An experiment map that connects datasets, metrics, baselines, and reported claims.
164- A limitations diagram that separates assumptions, failure modes, and open questions.132- A limitations diagram that separates assumptions, failure modes, and open questions.
165 133
166For Markdown-first reports, ask for Mermaid when the destination supports it, or a small checked-in SVG/PNG asset when it does not. Ask Codex to use the imagegen system skill, which comes with Codex by default, only when you need an illustrative, non-exact visual or something that doesn’t fit in a Markdown-native diagram.134For Markdown-first reports, ask for Mermaid when the destination supports it, or a small checked-in SVG/PNG asset when it does not. Ask ChatGPT to use the imagegen system skill, which comes with ChatGPT by default, only when you need an illustrative, non-exact visual or something that doesn't fit in a Markdown-native diagram.
167 135
168## Write the Markdown report136## Write the Markdown report
169 137
170Ask Codex to make the report self-contained enough that you can return to it later. A useful structure is:138Ask ChatGPT to make the report self-contained enough that you can return to it later. A useful structure is:
171 139
1721. Executive summary.1401. Executive summary.
1732. What to know before reading.1412. What to know before reading.
1787. What the paper does not prove.1467. What the paper does not prove.
1798. Open questions and follow-up reading.1478. Open questions and follow-up reading.
180 148
181The report should include source references wherever possible. For a PDF, ask for page, section, figure, or table references. If Codex cannot extract exact page references, it should say that and use section or heading references instead.149The report should include source references wherever possible. For a PDF, ask for page, section, figure, or table references. If ChatGPT cannot extract exact page references, it should say that and use section or heading references instead.
182 150
183## Use the report as a study loop151## Use the report as a study loop
184 152
185The first report is a starting point. After reading it, ask follow-up questions and have Codex revise the artifact.153The first report is a starting point. After reading it, ask follow-up questions and have ChatGPT revise the artifact.
186 154
187Useful follow-ups include:155Useful follow-ups include:
188 156
189- Which part of this method should I understand first?157- Which part of this method should I understand first?
190- What is the simplest toy example that demonstrates the core idea?158- What is the simplest toy example that demonstrates the core idea?
191- Which figure is doing the most work in the paper’s argument?159- Which figure is doing the most work in the paper's argument?
192- Which claim is weakest or least supported?160- Which claim is weakest or least supported?
193- What should I read next if I want to implement this?161- What should I read next if I want to implement this?
194 162
195When the concept requires experimentation, ask Codex to add a small notebook or script that recreates a toy version of the idea. Keep that scratch work linked from the Markdown report so the explanation and the experiment stay together.163When the concept requires experimentation, ask ChatGPT to add a small notebook or script that recreates a toy version of the idea. Keep that scratch work linked from the Markdown report so the explanation and the experiment stay together.
196 164
197Example prompt:165Example prompt:
198 166
199Generate a script that reproduces a simple example from this paper.
200The script should be self-contained and runnable with minimal dependencies.
201There should be a clear output I can review, such as a csv, plot, or other artifact.
202If there are code examples in the paper, use them as reference to write the script.
203
204## Skills to consider167## Skills to consider
205 168
206Use skills only when they match the artifact you want:169Use skills only when they match the artifact you want:
215 178
216**Create the Report Outline First**179**Create the Report Outline First**
217 180
218Before writing the full report, inspect [paper path] and propose the report outline.
219Include:
220- the core concept the paper is trying to explain
221- which sections or figures are most important
222- which background terms need definitions
223- which diagrams would help
224- which subagent tasks you would spawn before drafting
225Stop after the outline and wait for confirmation before creating files.
226
227**Build Diagrams for the Concept**181**Build Diagrams for the Concept**
228 182
229Read `notes/[concept-name]-report.md` and add diagrams that make the concept easier to understand.
230Use Markdown-native Mermaid diagrams when possible. If the report destination cannot render Mermaid, create small checked-in SVG files instead and link them from the report.
231Add:
232- one concept map for prerequisites and related ideas
233- one method flow diagram for inputs, transformations, and outputs
234- one evidence map connecting claims to paper figures, tables, or sections
235Keep the diagrams faithful to the report. Do not add unverified claims.
236
237**Turn the Report Into a Study Plan**183**Turn the Report Into a Study Plan**
238
239Use `notes/[concept-name]-report.md` to create a study plan for the next two reading sessions.
240Include:
241- what I should understand first
242- which paper sections to reread
243- which equations, figures, or tables need extra attention
244- one toy example or notebook idea if experimentation would help
245- follow-up readings and questions to resolve
246Update the report with a short "Next study loop" section.
247
248## Related use cases
249
250[
251
252### Complete tasks from messages
253
254Use Computer Use to read one Messages thread, complete the task, and draft a reply.
255
256Knowledge Work Integrations](https://developers.openai.com/codex/use-cases/complete-tasks-from-messages)[
257
258### Coordinate new-hire onboarding
259
260Use Codex to gather approved new-hire context, stage tracker updates, draft team-by-team...
261
262Integrations Data](https://developers.openai.com/codex/use-cases/new-hire-onboarding)[
263
264### Prioritize drug targets
265
266Use Codex with the Life Science Research plugin to normalize entities, retrieve genetics...
267
268Sciences Data](https://developers.openai.com/codex/use-cases/target-prioritization)
269