diff --git a/README.md b/README.md
index 4c6d159..c432eec 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,42 @@
-# life-science-ai-prompts
+# Life Science AI Prompts
 
-Curated AI prompts for life sciences: genomics, proteomics, CRISPR, cell biology, and literature synthesis. Analogous to awesome-ai-for-science and awesome-genomic-skills.
\ No newline at end of file
+> *Where the prompts live, thrive, and reach the world.*
+
+Curated, versioned AI prompts for life sciences research.
+Covers genomics, proteomics, CRISPR, cell biology, and literature synthesis.
+
+## Analogous Resources Ingested
+
+| Repository | Focus | Stars |
+|---|---|---|
+| [awesome-ai-for-science](https://github.com/ai-boost/awesome-ai-for-science) | AI tools across sciences | ★★★ |
+| [Awesome-LLM-Agents-Scientific-Discovery](https://github.com/zjlrock777/Awesome-LLM-Agents-Scientific-Discovery) | LLM agents in biomedical research | ★★★ |
+| [awesome-genomic-skills](https://github.com/GoekeLab/awesome-genomic-skills) | Genomic LLM agent skills | ★★★ |
+| [awesome-computational-biology](https://github.com/inoue0426/awesome-computational-biology) | Computational biology resources | ★★★ |
+| [Awesome-LLM-Scientific-Discovery](https://github.com/HKUST-KnowComp/Awesome-LLM-Scientific-Discovery) | LLMs for science | ★★★ |
+
+## Folder Structure
+
+```
+genomics/     — variant calling, RNA-seq, CRISPR
+proteomics/   — structure, mass spectrometry, interactions
+cell-biology/ — flow cytometry, microscopy, assays
+literature/   — paper summarisation, methods extraction
+```
+
+## How to Use
+
+```python
+import requests, base64
+
+GITEA_URL = "https://promptnotes.ai"
+TOKEN = "your-token"
+
+def read_prompt(owner, repo, path):
+    url = f"{GITEA_URL}/api/v1/repos/{owner}/{repo}/contents/{path}"
+    r = requests.get(url, headers={"Authorization": f"token {TOKEN}"})
+    return base64.b64decode(r.json()["content"]).decode()
+
+prompt = read_prompt("promptadmin", "life-science-ai-prompts",
+                     "genomics/variant-interpretation/snp-clinical-significance.md")
+```