Magic Prompt
Per-kind craft guidance, fetched by an agent immediately before it builds.
The skill teaches an agent how to deploy, plus about six lines on building well. So an agent asked for a slideshow invents its navigation, its transitions, its reflow and its progress indicator from scratch, differently every time, at the middle of its training distribution.
Magic Prompt is the other half: one playbook per kind, fetched for the kind about to be built.
curl -sS https://superartifacts.app/magic/slideshow \
-H "Authorization: Bearer $SUPER_ARTIFACTS_KEY"
Served, not installed
That is the load-bearing half. Improving a playbook improves every artifact built after that moment, with nobody reinstalling anything.
It is a second endpoint rather than more of the skill because the skill must stay installable
by an unauthenticated curl — most install recipes are exactly that, and it is documented as
safe to commit and sync. A per-account preference cannot be honoured inside a document with
no account attached to the request.
What a playbook contains
The shared floor — contrast, tap targets, keyboard, reduced motion, phone first — plus what specifically makes that kind good. For a slideshow: how it gets advanced, how the URL names the slide, what the one transition should be.
Two boundaries were decided rather than assumed. A playbook ships craft, never identity: artifacts are not styled by this system, so guidance that shipped a palette would contradict the product. And nothing in a playbook describes a capability that does not exist — the collection guidance is gated on the data plane actually being there, and today it is not.
Turning it off
An account can decline this, and the endpoint then answers 200 with one paragraph saying
so and telling the agent to build anyway. A status code that read as an error would invite
retry logic for a state that is not an error.
An agent should build regardless of what this endpoint does — and should not mention a failed fetch to the person. An owner is entitled to turn it off, and a fetch that failed is not worth a sentence of their attention.