Description

This PR adds the Prism skill, a visual DSL that empowers AI agents to generate beautiful, structured, and self-contained HTML documents.

What problem it solves

When AI agents generate complex technical documents (like architecture flows, RFCs, or decision records), plain markdown lacks the visual vocabulary to handle deep information hierarchy. Agents often output massive walls of text that are hard to scan. Prism solves this by providing an opinionated set of 45+ UI components (decisions, collapsible evidences, code references, metrics). It teaches the agent how to logically organize information, and compiles it into a single, zero-dependency HTML file without the agent ever writing a line of CSS.

Who uses this workflow

• Software Architects & Developers: Using agents to draft technical specifications, system architecture designs, and post-mortem analyses.
• AI Tooling Engineers: Who want their agent's output to have a robust information architecture (e.g., forcing agents to put evidence/roll-back plans in collapsible blocks to keep the top-level document scannable).
• Users of Claude Code / Codex: Anyone who needs highly readable, shareable artifacts from their CLI agents.

Attribution/inspiration source

The component design and visual system are heavily inspired by Notion's clean, minimalist aesthetic, ensuring the output is immediately familiar and readable to humans.

Example of how it's used

The agent natively writes a template using Prism's DSL instead of markdown:

<!-- Agent generates this structure -->
<p-decision status="rejected" verdict="P0">
  <template #title>Concurrent refresh causes token revocation</template>
  <p>Impacts all multi-tab users.</p>
</p-decision>

<p-collapse title="Trace & Evidence">
  <p-source path="src/auth.ts:42-48" lang="TypeScript">
    <pre><code>// Implementation details...</code></pre>
  </p-source>
</p-collapse>

Then the document is built into a self-contained HTML file (with all styles and components injected, no network requests needed to view):

node prism/build.js template.html index.html