draw-scene

Draw an illustration (scene, character, map route, product shot, social-media art) as an SVG or PNG by writing a short YAML scene that the scenec compiler checks and renders, with no image model and n

SKILL.md

GitHub

Draw a scene

You write a YAML scene. scenec compiles it to SVG and tells you, in text, what is wrong with it: warnings (fields it did not understand, objects out of frame) and art-director critiques (overlaps, empty space, low contrast). You never need to look at the picture.

Workflow

  1. Pick the closest recipe in recipes/ and copy it to a working file, for example scene.yaml:
    • explainer-reel: vertical 9:16 explainer frame
    • carousel: square or 4:5 carousel slide
    • personalized-wrapped: personalized "year in review" card
    • e-learning: course scene with people and a screen
    • illustrated-story: story or history scene
    • journey-map: route over the map of Europe
    • ad-variations: ad with variations
    • product-illustration: product illustration
  2. Change the content. Prefer group: (ready-made sets such as a workspace) and canvas.shot over placing every piece by hand. Look up names in references/catalog.md, or run npx @guilhermebkel/scenec catalog assets.
  3. Check: npx @guilhermebkel/scenec check scene.yaml. Read warnings and art. Exit code 1 means there is something to fix.
  4. Fix and check again. Stop after 5 cycles; if something still fails, say what is left instead of looping.
  5. Render: npx @guilhermebkel/scenec render scene.yaml -o out --png. Deliver out.svg and out.png.

Rules

  • Never edit the SVG by hand. Change the scene and render again.
  • A warning that says "you meant X" is almost always right: apply it.
  • Field names and values are listed in references/dsl.md. Do not invent fields.
  • Colors come from the theme or from canvas.colors; use names like primary and accent before hex values.
  • Custom SVG assets go under assets: and are sanitized; external links and scripts are removed.
  • npx @guilhermebkel/scenec schema prints the full JSON Schema if you need it.

Files

  • recipes/*.yaml: 8 scenes that compile with zero warnings and zero critiques.
  • references/dsl.md: the scene language (generated).
  • references/catalog.md: assets, groups, kits, themes, poses (generated).