Creating Artifacts

An artifact here is a document for a person to read, written as one self-contained HTML page and shared by its portal link. A reader can skim it in two minutes, comment on any block, and open the same link again after each revision. This skill covers when to make a page, what goes in it, how to write it, how to make it easy to comment on, and how to share it.

<skill> below is this skill's base directory. Run commands from the workspace root.

When to Make a Page

The reply in the chat is the default. It is read in the thread, in order, where the work happens. A page costs the reader a click and a switch of context, so make one only when the user asks for an artifact or a page, or when the document needs something a chat message cannot give: