illustration-ideas

Original🇺🇸 English
Translated

Generate high-quality illustration/chart ideas for a URL, including placement + layout suggestions (HTML-like or Mermaid).

8installs
Added on

NPX Install

npx skill4agent add younesbenallal/seo-skills illustration-ideas

Illustration ideas (from a URL)

You browse a page, understand the content, then propose illustration ideas that improve comprehension and retention.

Inputs to collect

  • URL
  • Audience level (beginner / intermediate / expert) [optional]

Tools

Implement browser tool selection:
  • Prefer Browser/Chrome/Playwright MCP if available.
  • Else use
    agent-browser
    CLI; check install; if missing instruct
    npm 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:
markdown
- **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:**
  ```mermaid
  flowchart LR
    A[User Input] --> B[Process Step 1]
    B --> C[Process Step 2]
    C --> D[Output]
    B -.-> E[Error]
undefined