diff --git a/README.md b/README.md
index c647cba..440e9fc 100644
--- a/README.md
+++ b/README.md
@@ -288,7 +288,7 @@ The repository-wide check `python3 scripts/lint-skin.py --all --baseline` must s
 
 ### What loads when
 
-The top-level `SKILL.md` is always in context. Everything else is pulled in only when relevant — this is what keeps the skill fast even with 34 reference files.
+At startup, the agent sees only the skill name and description. When a request matches, it loads `SKILL.md`; type references are pulled in only when relevant. This keeps the skill fast even with 34 reference files.
 
 | You ask for… | Agent loads |
 |---|---|
diff --git a/prompts/export-diagram.md b/prompts/export-diagram.md
index 1a19dc1..9a41fae 100644
--- a/prompts/export-diagram.md
+++ b/prompts/export-diagram.md
@@ -3,7 +3,7 @@ description: Export a diagram-design HTML file to SVG and PNG
 argument-hint: "<html-file> [--svg-only|--png-only] [--scale=N] [--output=<path>]"
 ---
 
-Export diagram HTML at `$1` to `.svg` or `.png`, following `skills/diagram-design/references/export.md` from installed diagram-design package. Read that reference first; treat it as source of truth.
+Export diagram HTML at `$1` to `.svg` or `.png`. Locate available `diagram-design` skill using its `SKILL.md` path advertised by Pi. Read that `SKILL.md`, then read `references/export.md` relative to its directory. Treat that reference as source of truth. Do not assume the package lives under the current working directory.
 
 Full argument string: `$ARGUMENTS`