docs: reorganize ClawBio tutorials into sequential 5-step workshop flow

Reorder tutorials for the Segun workshop (22 April): Run Skill → Build
Skill → Variant Interpretation → GWAS → 30x WGS. Add missing GWAS card
to index. Move Telegram Bot to bonus. Add step numbering to nav sidebar
and breadcrumb navigation to every tutorial page.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: manuelcorpas

docs/tutorials/30x-wgs-workshop.md

@@ -18,8 +18,8 @@ description: Explore a real 30x whole-genome sequence with ClawBio in Google Col
 !!! warning "Early release: testers welcome"
     This workshop has not been fully tested end-to-end. If you hit errors, please [file an issue on GitHub](https://github.com/ClawBio/ClawBio/issues) or message Manuel directly. Your feedback makes this better for everyone.
 
-!!! tip "Builds on Workshops 1 and 2"
-    This is the third and final workshop in the series. In the [Variant Interpretation Workshop](variant-interpretation-workshop.md) you analysed a SNP array (~600K positions). In the [GWAS Workshop](gwas-workshop.md) you scaled up to population-level analysis. Now you return to the same individual genome at **full 30x whole-genome sequencing resolution**, revealing variant types that are invisible to both arrays and summary statistics.
+!!! tip "Step 5 of 5: Builds on Steps 3 and 4"
+    This is the final step in the ClawBio tutorial sequence. In **Step 3** ([Variant Interpretation Workshop](variant-interpretation-workshop.md)) you analysed a SNP array (~600K positions). In **Step 4** ([GWAS Workshop](gwas-workshop.md)) you scaled up to population-level analysis. Now you return to the same individual genome at **full 30x whole-genome sequencing resolution**, revealing variant types that are invisible to both arrays and summary statistics.
 
 ## What's new compared to previous workshops
 
@@ -275,3 +275,7 @@ The notebook extracts 20 PASS variants from chromosome 20 and runs ClawBio's var
 | gnomAD | [gnomad.broadinstitute.org](https://gnomad.broadinstitute.org/) |
 | UCSC Genome Browser | [genome.ucsc.edu](https://genome.ucsc.edu) |
 | CPIC Guidelines | [cpicpgx.org](https://cpicpgx.org/) |
+
+**Previous:** [GWAS Workshop](gwas-workshop.md) | **Back to:** [All Tutorials](index.md)
+
+**Full workshop sequence:** [Run Your First Skill](run-your-first-skill.md) :material-arrow-right: [Build a Skill](build-a-skill.md) :material-arrow-right: [Variant Interpretation](variant-interpretation-workshop.md) :material-arrow-right: [GWAS](gwas-workshop.md) :material-arrow-right: 30x WGS

docs/tutorials/build-a-skill.md

@@ -214,4 +214,6 @@ See [Contributing](../contributing/index.md) for PR guidelines.
 
 ---
 
-**Next:** [Variant Interpretation Workshop](variant-interpretation-workshop.md) — analyse a real genome hands-on.
+**Previous:** [Run Your First Skill](run-your-first-skill.md) | **Next step:** [Variant Interpretation Workshop](variant-interpretation-workshop.md) — analyse a real genome hands-on.
+
+**Full workshop sequence:** [Run Your First Skill](run-your-first-skill.md) :material-arrow-right: Build a Skill :material-arrow-right: [Variant Interpretation](variant-interpretation-workshop.md) :material-arrow-right: [GWAS](gwas-workshop.md) :material-arrow-right: [30x WGS](30x-wgs-workshop.md)

docs/tutorials/gwas-workshop.md

@@ -18,8 +18,8 @@ description: Run a complete GWAS analysis with ClawBio in Google Colab. Variant
 !!! tip "Runs in Google Colab"
     All code in this workshop runs in Google Colab. Open a new notebook, clone ClawBio (`!git clone https://github.com/ClawBio/ClawBio.git` then `%cd ClawBio` and `!pip install -q -r requirements.txt`), and follow along.
 
-!!! tip "Builds on the Variant Interpretation Workshop"
-    This is the second workshop in the series. In the [Variant Interpretation Workshop](variant-interpretation-workshop.md) you annotated a **single genome** and found clinically relevant variants. Now we scale up: from one person to **population-level** analysis using GWAS summary statistics. You will query the same variant (rs429358/APOE) you found before, but this time across thousands of genomes and nine databases.
+!!! tip "Step 4 of 5: Builds on the Variant Interpretation Workshop"
+    This is **Step 4** in the ClawBio tutorial sequence. In **Step 3** ([Variant Interpretation Workshop](variant-interpretation-workshop.md)) you annotated a **single genome** and found clinically relevant variants. Now we scale up: from one person to **population-level** analysis using GWAS summary statistics. You will query the same variant (rs429358/APOE) you found before, but this time across thousands of genomes and nine databases.
 
 ---
 
@@ -207,3 +207,7 @@ You have now analysed variants at the individual level (Workshop 1) and the popu
 | Workshop | What it adds |
 |----------|-------------|
 | [30x WGS Workshop](30x-wgs-workshop.md) | Analyse Manuel Corpas's genome at **full 30x whole-genome sequencing resolution**. Discover 8,925 structural variants, 912K indels, and copy number changes that are invisible to both SNP arrays and summary statistics. Compare WGS findings with the SNP chip results from Workshop 1. |
+
+**Previous:** [Variant Interpretation Workshop](variant-interpretation-workshop.md) | **Next step:** [30x WGS Workshop](30x-wgs-workshop.md)
+
+**Full workshop sequence:** [Run Your First Skill](run-your-first-skill.md) :material-arrow-right: [Build a Skill](build-a-skill.md) :material-arrow-right: [Variant Interpretation](variant-interpretation-workshop.md) :material-arrow-right: GWAS :material-arrow-right: [30x WGS](30x-wgs-workshop.md)

docs/tutorials/index.md

@@ -136,37 +136,46 @@ Hands-on guides to get productive with AI coding tools and ClawBio. Each tutoria
     <span class="time-estimate">30 min</span>
   </div>
   <h3 class="tutorial-card__title">Build a Skill</h3>
-  <p class="tutorial-card__desc">Write a complete ClawBio skill from scratch — SKILL.md, Python, demo data, validation.</p>
+  <p class="tutorial-card__desc">Write a complete ClawBio skill from scratch: SKILL.md contract, Python implementation, demo data, and validation.</p>
 </a>
 
-<a class="tutorial-card" href="telegram-bot/">
+<a class="tutorial-card" href="variant-interpretation-workshop/">
   <div class="tutorial-card__header">
     <span class="tutorial-card__step">STEP 3</span>
-    <span class="difficulty-badge difficulty-badge--intermediate">Intermediate</span>
-    <span class="time-estimate">20 min</span>
+    <span class="difficulty-badge difficulty-badge--beginner">Beginner</span>
+    <span class="time-estimate">60 min</span>
   </div>
-  <h3 class="tutorial-card__title">Telegram Bot</h3>
-  <p class="tutorial-card__desc">Deploy RoboTerri — a Telegram bot that runs ClawBio skills via any LLM provider.</p>
+  <h3 class="tutorial-card__title">Variant Interpretation Workshop</h3>
+  <p class="tutorial-card__desc">Annotate a real human genome in Google Colab. Variant annotation, pharmacogenomics, and clinical interpretation. No prior experience required.</p>
 </a>
 
-<a class="tutorial-card" href="variant-interpretation-workshop/">
+<a class="tutorial-card" href="gwas-workshop/">
   <div class="tutorial-card__header">
-    <span class="tutorial-card__step">WORKSHOP</span>
-    <span class="difficulty-badge difficulty-badge--beginner">Beginner</span>
-    <span class="time-estimate">60 min</span>
+    <span class="tutorial-card__step">STEP 4</span>
+    <span class="difficulty-badge difficulty-badge--intermediate">Intermediate</span>
+    <span class="time-estimate">30 min</span>
   </div>
-  <h3 class="tutorial-card__title">Variant Interpretation Workshop</h3>
-  <p class="tutorial-card__desc">Annotate a real human genome in Google Colab. No installation, no terminal, no prior experience required. Covers variant annotation, pharmacogenomics, and clinical interpretation.</p>
+  <h3 class="tutorial-card__title">GWAS Workshop</h3>
+  <p class="tutorial-card__desc">Scale from one genome to population-level analysis. GWAS variant lookup across 9 databases, polygenic risk scores, and SuSiE fine-mapping.</p>
 </a>
 
 <a class="tutorial-card" href="30x-wgs-workshop/">
   <div class="tutorial-card__header">
-    <span class="tutorial-card__step">WORKSHOP</span>
+    <span class="tutorial-card__step">STEP 5</span>
     <span class="difficulty-badge difficulty-badge--intermediate">Intermediate</span>
     <span class="time-estimate">40 min</span>
   </div>
   <h3 class="tutorial-card__title">30x WGS Workshop</h3>
-  <p class="tutorial-card__desc">Explore a real 30x whole-genome sequence in Google Colab. Structural variants, QC metrics, pharmacogenomics comparison. Goes beyond what SNP arrays can see.</p>
+  <p class="tutorial-card__desc">Explore a real 30x whole-genome sequence. Structural variants, QC metrics, and pharmacogenomics comparison. Goes beyond what SNP arrays can see.</p>
+</a>
+
+<a class="tutorial-card" href="telegram-bot/">
+  <div class="tutorial-card__header">
+    <span class="difficulty-badge difficulty-badge--intermediate">Intermediate</span>
+    <span class="time-estimate">20 min</span>
+  </div>
+  <h3 class="tutorial-card__title">Telegram Bot (Bonus)</h3>
+  <p class="tutorial-card__desc">Deploy RoboTerri, a Telegram bot that runs ClawBio skills via any LLM provider.</p>
 </a>
 
 </div>

docs/tutorials/run-your-first-skill.md

@@ -100,4 +100,6 @@ The agent reads the SKILL.md to understand what the skill does and how to call i
 
 ---
 
-**Next:** [Build a Skill](build-a-skill.md) — create your own skill from scratch.
+**Next step:** [Build a Skill](build-a-skill.md) — create your own skill from scratch.
+
+**Full workshop sequence:** Run Your First Skill :material-arrow-right: [Build a Skill](build-a-skill.md) :material-arrow-right: [Variant Interpretation](variant-interpretation-workshop.md) :material-arrow-right: [GWAS](gwas-workshop.md) :material-arrow-right: [30x WGS](30x-wgs-workshop.md)

docs/tutorials/variant-interpretation-workshop.md

@@ -15,6 +15,9 @@ description: Annotate a real human genome with ClawBio in Google Colab. No insta
 [:material-open-in-new: Launch the workshop in Google Colab](https://colab.research.google.com/github/ClawBio/ClawBio/blob/main/docs/tutorial-variant-interpretation.ipynb){ .md-button .md-button--primary }
 [:material-presentation-play: View introductory slides](https://clawbio.ai/workshop-slides.html){ .md-button }
 
+!!! tip "Step 3 of 5: Your first hands-on genomics workshop"
+    This is **Step 3** in the ClawBio tutorial sequence. In [Step 1](run-your-first-skill.md) you ran a skill demo. In [Step 2](build-a-skill.md) you built a skill from scratch. Now you apply ClawBio to a real human genome: variant annotation, pharmacogenomics, and clinical interpretation.
+
 ---
 
 ## Part 1: What is ClawBio?
@@ -378,3 +381,7 @@ This workshop analysed a **single genome** using a **SNP array** (~600K position
 |----------|-------------|-------|
 | [GWAS Workshop](gwas-workshop.md) | Scale from one genome to **population-level** analysis. Query nine GWAS databases, compute polygenic risk scores, and fine-map causal variants using public summary statistics. | Intermediate |
 | [30x WGS Workshop](30x-wgs-workshop.md) | Analyse the **same genome at full resolution** (30x whole-genome sequencing). Discover structural variants, indels, and copy number changes invisible to SNP arrays. | Intermediate |
+
+**Previous:** [Build a Skill](build-a-skill.md) | **Next step:** [GWAS Workshop](gwas-workshop.md)
+
+**Full workshop sequence:** [Run Your First Skill](run-your-first-skill.md) :material-arrow-right: [Build a Skill](build-a-skill.md) :material-arrow-right: Variant Interpretation :material-arrow-right: [GWAS](gwas-workshop.md) :material-arrow-right: [30x WGS](30x-wgs-workshop.md)

mkdocs.yml

@@ -62,11 +62,11 @@ nav:
       - tmux Sessions: tutorials/tmux-sessions.md
       - Telegram Bot: tutorials/telegram-bot.md
     - ClawBio:
-      - Run Your First Skill: tutorials/run-your-first-skill.md
-      - Build a Skill: tutorials/build-a-skill.md
-      - Variant Interpretation Workshop: tutorials/variant-interpretation-workshop.md
-      - GWAS Workshop: tutorials/gwas-workshop.md
-      - 30x WGS Workshop: tutorials/30x-wgs-workshop.md
+      - "Step 1 — Run Your First Skill": tutorials/run-your-first-skill.md
+      - "Step 2 — Build a Skill": tutorials/build-a-skill.md
+      - "Step 3 — Variant Interpretation": tutorials/variant-interpretation-workshop.md
+      - "Step 4 — GWAS Workshop": tutorials/gwas-workshop.md
+      - "Step 5 — 30x WGS Workshop": tutorials/30x-wgs-workshop.md
   - Research:
     - Overview: research/index.md
     - Genomebook: research/genomebook.md