Skip to content

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

Move guide references into the introduction

Michael Ramosb537cf7608f3
diff --git a/site/content/docs/index.mdx b/site/content/docs/index.mdx
index 993a5d9..a04b404 100644
--- a/site/content/docs/index.mdx
+++ b/site/content/docs/index.mdx
@@ -7,6 +7,13 @@ 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.
+
## Start without a skill
You do not need to install a skill to use these patterns. Ask an agent to make
@@ -58,19 +65,6 @@ approach](/docs/designing-artifacts) that can sit above any of those forms. The
examples stay inspectable and source-grounded. They demonstrate the patterns;
they are not prerequisites for using them.
-## Where this guide comes from
-
-This guide organizes and extends public practices shared in Thariq Shihipar's
-[Claude Code article about effective
-HTML](https://claude.com/blog/using-claude-code-the-unreasonable-effectiveness-of-html)
-and its [example gallery](https://thariqs.github.io/html-effectiveness/),
-Geoffrey Litt's work on [understanding as the new
-bottleneck](https://www.geoffreylitt.com/2026/07/02/understanding-is-the-new-bottleneck),
-and projects such as [Frontend
-Slides](https://github.com/zarazhangrui/frontend-slides). They share a practical
-idea: agents can produce artifacts that help people inspect, understand, and
-participate in the work.
-
Continue with [why HTML](/docs/why-html), learn the generic approach to
[designing artifacts](/docs/designing-artifacts), or go directly to [choosing
fidelity](/docs/choosing-fidelity).