Skip to content

Agent skills for useful HTML artifacts, wireframes, interactive prototypes, plans, and diagrams.

Make guide source links obvious

Michael Ramos2eb6fa8f7feb
diff --git a/site/components/guide-evidence.module.css b/site/components/guide-evidence.module.css
index 9e545e9..3e5e1b3 100644
--- a/site/components/guide-evidence.module.css
+++ b/site/components/guide-evidence.module.css
@@ -155,6 +155,108 @@
border-top: 1px solid var(--color-fd-foreground);
}
+.sources {
+ display: grid;
+ grid-template-columns: repeat(2, minmax(0, 1fr));
+ column-gap: 1.5rem;
+ width: min(54rem, calc(100vw - 2rem));
+ margin-block: 1.25rem 2.75rem;
+ border-top: 1px solid
+ color-mix(in srgb, var(--color-fd-foreground) 32%, transparent);
+}
+
+.sources :global(a) {
+ display: grid;
+ grid-template-columns: auto minmax(0, 1fr) auto;
+ gap: 0.8rem;
+ align-items: center;
+ min-height: 5.5rem;
+ padding: 1rem 0.75rem 1rem 0.25rem;
+ border-bottom: 1px solid
+ color-mix(in srgb, var(--color-fd-foreground) 32%, transparent);
+ color: var(--color-fd-foreground);
+ text-decoration: none;
+ transition: background-color var(--duration-fast) ease-out;
+}
+
+.sources :global(a)::before {
+ width: 0.65rem;
+ height: 0.65rem;
+ background: var(--cobalt);
+ content: "";
+}
+
+.sources :global(a:nth-child(2))::before {
+ border-radius: 50%;
+ background: var(--green);
+}
+
+.sources :global(a:nth-child(3))::before {
+ background: var(--coral);
+ transform: rotate(45deg);
+}
+
+.sources :global(a:nth-child(4))::before {
+ background: var(--lilac);
+}
+
+.sources :global(a)::after {
+ width: 1rem;
+ height: 1rem;
+ background: currentColor;
+ content: "";
+ -webkit-mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M7 17 17 7'/%3E%3Cpath d='M7 7h10v10'/%3E%3C/svg%3E") center / contain no-repeat;
+ mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M7 17 17 7'/%3E%3Cpath d='M7 7h10v10'/%3E%3C/svg%3E") center / contain no-repeat;
+ transition: transform var(--duration-fast) ease-out;
+}
+
+.sources :global([data-source-copy]),
+.sources :global(strong),
+.sources :global(small) {
+ display: block;
+}
+
+.sources :global([data-source-copy]) {
+ min-width: 0;
+}
+
+.sources :global(strong) {
+ color: var(--cobalt);
+ font-family: var(--font-display);
+ font-size: var(--text-label);
+ letter-spacing: -0.015em;
+}
+
+.sources :global(small) {
+ margin-top: 0.2rem;
+ color: var(--color-fd-muted-foreground);
+ font-size: var(--text-label-compact);
+ font-weight: 500;
+ line-height: 1.4;
+}
+
+.sources :global(a:hover) {
+ background: color-mix(
+ in srgb,
+ var(--color-fd-foreground) 4%,
+ transparent
+ );
+}
+
+.sources :global(a:hover)::after {
+ transform: translate(0.2rem, -0.2rem);
+}
+
+.sources :global(a:hover strong) {
+ text-decoration: underline;
+ text-underline-offset: 0.2rem;
+}
+
+.sources :global(a:focus-visible) {
+ outline: 2px solid var(--color-fd-ring);
+ outline-offset: 4px;
+}
+
.chapterEvidence {
--evidence-accent: var(--cobalt);
width: min(54rem, calc(100vw - 2rem));
@@ -468,9 +570,14 @@
color: var(--lilac);
}
+:global(.dark) .sources :global(strong) {
+ color: var(--lilac);
+}
+
@media (max-width: 1280px) {
.workbench,
.handoff,
+ .sources,
.chapterEvidence {
width: 100%;
}
@@ -563,10 +670,18 @@
.handoff a {
min-height: 4.75rem;
}
+
+ .sources {
+ grid-template-columns: 1fr;
+ column-gap: 0;
+ margin-block: 1rem 2.25rem;
+ }
}
@media (prefers-reduced-motion: reduce) {
.handoff a > svg:last-child,
+ .sources :global(a),
+ .sources :global(a)::after,
.next svg {
transition: none;
}
diff --git a/site/components/guide-evidence.tsx b/site/components/guide-evidence.tsx
index 17bc7f2..458f327 100644
--- a/site/components/guide-evidence.tsx
+++ b/site/components/guide-evidence.tsx
@@ -3,7 +3,7 @@
import { ArrowRight, ArrowUpRight, FileCode2, Wrench } from "lucide-react";
import Image from "next/image";
import Link from "next/link";
-import type { CSSProperties, KeyboardEvent } from "react";
+import type { CSSProperties, KeyboardEvent, ReactNode } from "react";
import { useRef, useState } from "react";
import styles from "./guide-evidence.module.css";
@@ -445,6 +445,15 @@ export function GuideHandoff({
);
}
+/** Render a compact, visibly interactive source ledger inside guide prose. */
+export function GuideSources({ children }: { children: ReactNode }) {
+ return (
+ <nav className={styles.sources} aria-label="Sources behind this guide">
+ {children}
+ </nav>
+ );
+}
+
export function GuideNext({
href,
title,
diff --git a/site/components/mdx.tsx b/site/components/mdx.tsx
index b5b06d8..eba096e 100644
--- a/site/components/mdx.tsx
+++ b/site/components/mdx.tsx
@@ -5,6 +5,7 @@ import {
GuideChapterEvidence,
GuideHandoff,
GuideNext,
+ GuideSources,
} from "@/components/guide-evidence";
export function getMDXComponents(components?: MDXComponents) {
@@ -14,6 +15,7 @@ export function getMDXComponents(components?: MDXComponents) {
GuideChapterEvidence,
GuideHandoff,
GuideNext,
+ GuideSources,
...components,
} satisfies MDXComponents;
}
diff --git a/site/content/docs/index.mdx b/site/content/docs/index.mdx
index a04b404..587c43e 100644
--- a/site/content/docs/index.mdx
+++ b/site/content/docs/index.mdx
@@ -7,12 +7,50 @@ Effective HTML is a field guide to making visual, interactive artifacts with
agents. It is for developers and for anyone who needs to understand, review, or
direct agent work.
-This guide collects ideas from Anthropic engineer Thariq Shihipar's [essay on
-effective HTML](https://claude.com/blog/using-claude-code-the-unreasonable-effectiveness-of-html)
-and [examples](https://thariqs.github.io/html-effectiveness/), Geoffrey Litt's
-[work on understanding](https://www.geoffreylitt.com/2026/07/02/understanding-is-the-new-bottleneck),
-and [Frontend Slides](https://github.com/zarazhangrui/frontend-slides) in one
-place.
+This guide collects ideas from:
+
+<GuideSources>
+ <a
+ href="https://claude.com/blog/using-claude-code-the-unreasonable-effectiveness-of-html"
+ target="_blank"
+ rel="noreferrer"
+ >
+ <span data-source-copy>
+ <strong>The unreasonable effectiveness of HTML</strong>
+ <small>Thariq Shihipar · Anthropic</small>
+ </span>
+ </a>
+ <a
+ href="https://thariqs.github.io/html-effectiveness/"
+ target="_blank"
+ rel="noreferrer"
+ >
+ <span data-source-copy>
+ <strong>HTML effectiveness examples</strong>
+ <small>Twenty inspectable HTML artifacts</small>
+ </span>
+ </a>
+ <a
+ href="https://www.geoffreylitt.com/2026/07/02/understanding-is-the-new-bottleneck"
+ target="_blank"
+ rel="noreferrer"
+ >
+ <span data-source-copy>
+ <strong>Understanding is the new bottleneck</strong>
+ <small>Geoffrey Litt</small>
+ </span>
+ </a>
+ <a
+ href="https://github.com/zarazhangrui/frontend-slides"
+ target="_blank"
+ rel="noreferrer"
+ >
+ <span data-source-copy>
+ <strong>Frontend Slides</strong>
+ <small>GitHub repository</small>
+ </span>
+ </a>
+</GuideSources>
## Start without a skill