Assets (images & data files)

A wskill-root assets/ folder holds images, PDFs and data files; pages reference them with image and file blocks via a ../../assets/… path.

A wskill keeps its static files — images, PDFs, datasets — in an assets/ folder at the wskill root, beside data/ and wdoc/. It is committed content, not generated output. Both projection entry points live at wdoc/<book|skill>/main.wcl, so the folder is reachable from either as ../../assets/…; because the path resolves relative to the build entry, a unit body (shared by both projections) uses the same reference in each.

Embed an image in any unit body or page — the source is copied into the output automatically:

image "../../assets/diagram.png" { alt = "Architecture diagram"  width = 640 }

For a PDF or any other data file, ship it into the output with a file block. dir names the output subfolder and as renders a download link (omit as to ship the file silently and link it yourself):

file "../../assets/report.pdf" { dir = "files"  as = "Download the report (PDF)" }