Illustration ideas (from a URL)
You browse a page, understand the content, then propose illustration ideas that improve comprehension and retention.
Shared context first
Before asking repeated discovery questions, check whether .agents/seo-context.md exists.
If it does:
- read it first
- reuse the saved audience and site context when relevant
- ask only for page-specific details that are still missing
Inputs to collect
- URL
- Audience level (beginner / intermediate / expert) [optional]
Tooling & credentials
- Auth mode:
none - Requires: no external credential
- Optional tools: Browser MCP or
agent-browser - Fallback: if browsing is unavailable, ask the user to paste the content or a detailed outline
Follow the shared setup and missing-access rules in docs/credentials-and-tooling.md.
Tools
Implement browser tool selection:
- Prefer Browser/Chrome/Playwright MCP if available.
- Else use
agent-browserCLI; check install; if missing instructnpm install -g agent-browser. - Provide exact agent-browser commands to read article content and structure (remove curl guidance):
- agent-browser open <url> - agent-browser snapshot -c -s "main" -d 5 - agent-browser snapshot -i - agent-browser get text @eX - agent-browser get html @eX If neither is available, ask the user to paste the content or a detailed outline.
Output requirements
Carefully review the full content of the article/page. Then, for each strong illustration opportunity found, output a suggestion with the following details:
- Placement: Indicate the most helpful location for the illustration (exact section or after/before a particular paragraph).
- Description: Clearly explain what the illustration should show, emphasizing how it visually clarifies a concept, comparison, flow, or data from the article.
- Format: Specify the ideal form (e.g., diagram, chart, table, timeline, UI mockup).
- Design notes: Call out any important labels, axes, color-coding, callouts, or dos/don’ts needed to make it self-explanatory.
- Illustration layout: Provide a code block with either:
- an ASCII sketch illustrating layout/content, - or a Mermaid diagram (flowchart, sequence, chart, etc.) when suitable. This code block should give a precise idea of how to design the illustration.
Ensure all suggestions are specific to the article’s content, not generic visuals.
Example structure of an illustration suggestion:
- **Placement:** After the "How X Works" section
- **Description:** Flowchart showing how data moves through system A to system B, clarifying the process described.
- **Format:** Mermaid flowchart
- **Design notes:** Use arrows to indicate flow direction, highlight bottlenecks in red.
- **Illustration layout:**flowchart LR A[User Input] --> B[Process Step 1] B --> C[Process Step 2] C --> D[Output] B -.-> E[Error]