diagram-generatorlisted

# Diagram Generator — From Content to Structure When an article is created or updated, this skill generates a conceptual diagram that captures the logical structure: key concepts, directional relations, and contextual copy for each node. ## When to use - A new article is published and needs a visual structure - An existing article is updated and the diagram is stale - The operator asks for a conceptual map of any content - The admin panel "Generate Diagram AI" button is clicked ## How it works 1. Read the article content (title + body) 2. Extract 3-7 key concepts as nodes 3. Identify relations: cause→effect, sequence, dependency, tension 4. Generate contextual copy for each node (observer positioning: when → content → result) 5. Produce a DiagramSpec JSON compatible with the renderer ## Two modes **LLM mode** (default): sends content to LLM API. Best results — understands narrative. Requires: `GODEL_API_KEY` + `GODEL_API_URL` (or `DIAGRAM_API_KEY` + `DIAGRAM_API_URL`) **Structural mode**: rule-based extraction from headers and text patterns. No API needed. Use when: offline, quick generation, or API unavailable. ## CLI ```bash # LLM mode python diagram_generator.py --content article.md --json # Structural mode python diagram_generator.py --content article.md --structural --json # From stdin cat article.md | python diagram_generator.py --stdin --title "Article Title" ``` ## As library ```python from diagram_generator import generate_diagram, generate_diagram_stru