The prompt
Score 10 of 10, Excellent
Use it when A report has photos and charts that need captions saying what each one shows and why it is there, with the numbers right.
- {{document}}
- {{readers}}
- {{images}}
- {{report_points}}
- {{style}}
Full prompt and why it works
Prompt
Write captions for the photos, charts and diagrams in {{document}}, from the descriptions and data below, for {{readers}}. Many readers skim a report by its pictures and read only the captions, so each caption should tell them what the image shows and why it is there, and each chart caption should state the takeaway with its numbers, so that someone who reads only the captions still gets the main points right. The images in order, each with its number, what it shows, where it sits in the report, the data behind it (for charts) and the credit or source: """ {{images}} """ The report's main points, or the section each image supports: {{report_points}} House style for captions (numbering such as "Figure 3", credit format, sentence case, length): {{style}} For each image, write these, in this order: 1. The label and number, in the house style. 2. A caption of one or two sentences, under 35 words: - Photos: who or what is shown, where and when as given, and why it matters to the section. Name people only as the descriptions name them. - Charts and tables: the takeaway first, with the figures that show it, then the period and unit. For example: "Figure 4. Late deliveries fell from [x]% to [y]% after the routing change in [month]. Share of orders, by month, [period]." That example shows the form only. - Diagrams: what process or structure it shows, in one sentence. 3. The source or credit line, exactly as supplied. The captions should be specific and factual, and should not repeat the report's body text word for word. These are captions for all readers, not alt text for screen readers: say what the image means for the report rather than describing every visual detail. Do not state a takeaway the data does not show, round numbers in a way that changes the point, or add numbers that are not in the data. Do not identify people, places or dates that the descriptions do not give. If an image has no credit or source, write [CREDIT NEEDED] rather than leaving it blank or guessing. If a chart's data is missing, write the descriptive part of the caption and add [TAKEAWAY NEEDS DATA].
Variables
- {{document}}
- The report, for example "our annual sustainability report".
- {{readers}}
- Who reads it, for example "customers, investors and staff".
- {{images}}
- Each image with its number, a description, the data behind any chart and its credit or source.
- {{report_points}}
- The report's main points, or which section each image supports.
- {{style}}
- Your caption style, or "none".
Why it works
- What good looks like. Chart captions lead with the takeaway and its figures, so a reader who skims only the captions still leaves with the right points.
- What to avoid. The caption states only what the data supports, and identifies no person or place the descriptions do not name.
- If unsure. A missing credit or missing chart data gets a marker instead of a guess, so nothing goes to print unsourced.