ruling-pagelisted
Install: claude install-skill Traction-AI-Labs/skills
<!-- SOURCE-REVISION 9c099e97 -->
# Ruling page
Complicated decisions go to the person as a page they click through, never as a document they have
to read ("see the table in plan.md", "answer K1 to K10 at the top of the spec"). Simple decisions stay
in chat: an HTML page for a yes/no is noise.
**Simple or complicated?** One yes/no, or a pick between two options whose difference fits on one
line: ask in chat, with your recommendation and a one-line why. Several decisions, or options with
real trade-offs: build a page.
**A design decision shows each option as a picture**, even a two-way pick that would otherwise stay in chat: a page
with a frame or screenshot per option (the card's `frames`, step 2; a `data:` URI in the Claude app, where there is
no folder beside the page), each annotated to mark what differs between the options, or a clickable mock. Never offer
visual options in words alone.
## Build it
1. Copy `references/template.html` next to the record the decisions belong to (the plan, spec or
status folder; a private one when a client or third party can read that folder), named for what it rules on, for example `2026-10-02-pricing-rulings.html`.
**In the Claude app**, where there is no local folder, fill the template and show it as an HTML
artifact instead; the rest of this skill is the same.
2. In the data script, replace `RULER`, `BRIEF` and `D` (keep the `svg` helper above `D` if your
frames use inline SVG), and the `<h1>`; the sample shows each kind