Skip to content

Open-source design agent: on-brand stills, decks, diagrams, charts and motion graphics from a chat thread, built on Deep Agents.

Skills: data models show required relationships; motion keeps frame 0 off a blank ground

Amal Irgashev4efca0895f84
diff --git a/skills/data-viz/SKILL.md b/skills/data-viz/SKILL.md
index 0c0f30b..789b0c6 100644
--- a/skills/data-viz/SKILL.md
+++ b/skills/data-viz/SKILL.md
@@ -70,6 +70,9 @@ Start from an example: [bar with one annotated bar](examples/bar-annotated.json)
- **Fewest words.** `title` and `caption` only when the ask supplies them or the figure misreads
without them; a caption is a source line, nothing more. The explanation goes in your reply.
- **One accent per frame**: the highlighted bar, line, point or stage. Everything else is quiet.
+- **A data model shows its rules.** When the ask says a relationship is required or optional ("at
+ least one user", "can relate to"), put it on the edge (`label`: `1..*`, `0..*`) rather than in a
+ footnote: that rule is usually the reason for the diagram.
- **Look at the PNG** (`node /workspace/tools/review-thumb.mjs <png>`, then `look`) before you deliver.
Gates prove the numbers and the structure, not the taste: crowded labels, a lopsided layout or a
weak concept are still yours to catch. A blog or doc figure is read about 720 px wide; check that
diff --git a/skills/motion-direction/SKILL.md b/skills/motion-direction/SKILL.md
index 9be5e05..575c964 100644
--- a/skills/motion-direction/SKILL.md
+++ b/skills/motion-direction/SKILL.md
@@ -36,7 +36,9 @@ below serves that.
- **The concept gate** (`brand-design`): a real thing shown, a specific idea, or bold type. Decorative
nodes, dots and glows are never the idea.
- **The hook is complete inside the first second**: something on frame 0 already moving, the
- statement readable with the sound off. Frame 0 is also the poster.
+ statement readable with the sound off. Frame 0 is also the poster. `artifact-contract`'s
+ `--allow-blank-ends` is for a fade from or to a flat ground the person asked for, never to get a
+ blank opening past the gate.
- **The turn** is the one concrete thing the film pivots on, as an image: a before and after, many
becoming one, the impossible made possible.
- **Proof on screen**: the real product surface, the real number with its source. A claim with no
diff --git a/workspace/tools/artifact-contract.mjs b/workspace/tools/artifact-contract.mjs
index dd89705..e529064 100644
--- a/workspace/tools/artifact-contract.mjs
+++ b/workspace/tools/artifact-contract.mjs
@@ -12,7 +12,7 @@
// names, at exactly W x H. Stills (PNG, JPEG, WebP) are read from their header bytes, no image
// library needed. A video expectation adds @<seconds>: ffprobe must report that duration within one
// frame, and the first and last frames must not be blank (frame 0 is the poster and the thumbnail);
-// --allow-blank-ends accepts a deliberate fade from or to a flat ground.
+// --allow-blank-ends accepts a fade from or to a flat ground that the person asked for.
// In --phase final, a contract whose output names a `path` is measured the same way.
//
// Relative paths resolve against --root (default: the folder holding tools/, i.e. /workspace) and