Imported from GithubLarsKomo/skillz (plugins/skillz/skills/learning-visual-planner/SKILL.md). Install upstream with npx skills add GithubLarsKomo/skillz --skill learning-visual-planner. Copyright stays with the author.

Learning Visual Planner

Grundsatz

Message first, visual second. Ein Visual ist nur gerechtfertigt, wenn es Verständnis, Orientierung, Erinnerung oder sichere Ausführung verbessert.

Repräsentationswahl

Bevorzugte Zuordnung:

SVG/Diagramm wird bevorzugt, wenn Geometrie, Labels und Logik wichtiger sind als Fotorealismus.

learning-visual-plan.json

Jedes Asset enthält mindestens:

{
  "id": "V-01",
  "message": "...",
  "sourceClaims": ["C-01"],
  "timestamps": ["00:12:14"],
  "visualType": "process-diagram",
  "assetMode": "generated-svg",
  "labels": [],
  "altTextIntent": "...",
  "targetSurfaces": ["html", "pptx", "docx", "pdf"],
  "designRequirements": [],
  "evidenceRole": "explanatory"
}

Source-Frame-Regel

Originalframes sind Evidenzanker, nicht Default-Illustrationen. Nutze sie nur, wenn der reale Zustand selbst relevant ist. Für übertragbare Lernlogik bevorzuge neu gezeichnete, sachlich abgeleitete Visuals.

Anti-Slop

Nicht planen:

• dekorative Stock-/AI-Bilder ohne Lernfunktion;
• beliebige Hero-Illustrationen, die keinen Claim transportieren;
• 3D-/Glassmorphism-Effekte ohne Informationswert;
• Text, der eigentlich HTML/SVG sein sollte, als Rasterbild;
• komplexe Diagramme nur um Fläche zu füllen;
• Farbvielfalt ohne semantische Rolle.

Qualitätsgate

• jedes Visual besitzt eine klare Lernbotschaft;
• jeder fachliche Bestandteil ist auf Claims/Evidenz zurückführbar;
• geeigneter Asset-Typ ist begründet;
• evidenceRole trennt source, explanatory und illustrative-only;
• target surfaces und DESIGN.md-Anforderungen sind vor Rendering bekannt.

Abschluss

Abgeschlossen, wenn SVG- und Bildgeneratoren ein eindeutiges, evidenzgebundenes Briefing erhalten, ohne eigene fachliche Entscheidungen treffen zu müssen.