diff --git a/public/index.html b/public/index.html
index cadec91c5..31ccd4639 100644
--- a/public/index.html
+++ b/public/index.html
@@ -299,7 +299,7 @@
         </div>
       </div>
 
-      <p class="download-tip" data-reveal>Once installed, keep the <a href="/cheatsheet">command cheatsheet</a> handy for quick reference.</p>
+      <p class="download-tip" data-reveal>Once installed, keep the <a href="/cheatsheet">command cheatsheet</a> handy for quick reference. To update, run <code>npx skills update</code>.</p>
     </section>
 
     <!-- 5. CHANGELOG -->
@@ -392,6 +392,18 @@
           </div>
         </details>
 
+        <details class="faq-item">
+          <summary class="faq-question">How do I update to the latest version?</summary>
+          <div class="faq-answer">
+            <ul>
+              <li><strong>All tools:</strong> <code>npx skills update</code> (or <code>npx skills check</code> to see what's new first)</li>
+              <li><strong>Claude Code plugin:</strong> Open <code>/plugin</code>, go to the Discover tab, and update from there</li>
+              <li><strong>Manual ZIP:</strong> Download the latest ZIP from above and extract to your project root, overwriting existing files</li>
+            </ul>
+            <p>Your <code>.impeccable.md</code> design context file (created by <code>/teach-impeccable</code>) is never overwritten — your project context is preserved across updates.</p>
+          </div>
+        </details>
+
         <details class="faq-item">
           <summary class="faq-question">Commands or skills aren't appearing. What do I do?</summary>
           <div class="faq-answer">