task icon Task

Create Visual Explainer

Requirements
Topic to explain with target audience (beginner/expert). Optional: visual style (infographic, diagram, illustrated), key points to emphasize.
Instructions
You MUST use a todo list to complete these steps in order. Never move on to one step if you haven't completed the previous step. If you have multiple read steps in a row, read them all at once (in parallel).
2

Ask the user what topic or concept they'd like a visual explainer for. This can be anything: a technical concept (context windows, neural networks), a process (photosynthesis, coffee brewing), a thing (a specific plant species, a product), or any subject. If they've also provided an image, note that you'll incorporate it into the explainer.

4

Research the topic and distill into EXACTLY 4 data points (not more!). Each data point needs: a 1-2 word LABEL and a 2-5 word VALUE. Examples: 'ORIGIN: West Africa' or 'SIZE: 4K to 200K Tokens'. If something needs more than 5 words, simplify it or split into two points. Write out your 4 data points clearly.

6

Build the infographic prompt using the EXACT template from the style guide. Copy the template structure and fill in: (1) Topic and background color. (2) Title banner with short title. (3) Central image description. (4) Four data points in cream boxes with icons, labels, and short values. (5) The full style description ending with 'museum placard aesthetic'. The prompt must be detailed and specific about colors, boxes, typography, and whitespace. Show user the complete prompt for approval.

8

Show the user their visual explainer and where it was saved. Offer to refine the style, adjust data points, or create explainers for related topics.

                    To run this task you must have the following required information:

> Topic to explain with target audience (beginner/expert). Optional: visual style (infographic, diagram, illustrated), key points to emphasize.

If you don't have all of this information, exit here and respond asking for any extra information you require, and instructions to run this task again with ALL required information.

---

You MUST use a todo list to complete these steps in order. Never move on to one step if you haven't completed the previous step. If you have multiple read steps in a row, read them all at once (in parallel).

Add all steps to your todo list now and begin executing.

## Steps

1. [Run Code: Verify Gemini Connection]: Call `run_script` with:

```json
{
  "file": {
    "path": https://sk.ills.app/code/media.gemini.verify/preview,
    "args": [

    ]
  },
  "packages": null
}
```

2. Ask the user what topic or concept they'd like a visual explainer for. This can be anything: a technical concept (context windows, neural networks), a process (photosynthesis, coffee brewing), a thing (a specific plant species, a product), or any subject. If they've also provided an image, note that you'll incorporate it into the explainer.

3. [Read Explainer Category Templates]: Read the documentation in: `./skills/sauna/[skill_id]/references/media.explainer.categories.md` (Load data templates for different subject types)

4. Research the topic and distill into EXACTLY 4 data points (not more!). Each data point needs: a 1-2 word LABEL and a 2-5 word VALUE. Examples: 'ORIGIN: West Africa' or 'SIZE: 4K to 200K Tokens'. If something needs more than 5 words, simplify it or split into two points. Write out your 4 data points clearly.

5. [Read Infographic Style Guide]: Read the documentation in: `./skills/sauna/[skill_id]/references/media.explainer.style.md` (Load infographic layout and prompting guidance)

6. Build the infographic prompt using the EXACT template from the style guide. Copy the template structure and fill in: (1) Topic and background color. (2) Title banner with short title. (3) Central image description. (4) Four data points in cream boxes with icons, labels, and short values. (5) The full style description ending with 'museum placard aesthetic'. The prompt must be detailed and specific about colors, boxes, typography, and whitespace. Show user the complete prompt for approval.

7. [Gather Arguments: Generate or Edit Image] The next step has the following requirements for arguments, do not proceed until you have all the required information:
- `prompt`: the complete infographic prompt with all text content and visual description
- `imagePath`: path to user's image if they provided one, otherwise empty string
- `outputDir`: ./documents/explainers/*

8. [Run Code: Generate or Edit Image]: Call `run_script` with:

```json
{
  "file": {
    "path": https://sk.ills.app/code/media.image.generate/preview,
    "args": [
      "prompt",
      "imagePath",
      "outputDir"
    ]
  },
  "packages": null
}
```

9. Show the user their visual explainer and where it was saved. Offer to refine the style, adjust data points, or create explainers for related topics.