diff --git a/README.md b/README.md
index 5d2c417..f985c92 100644
--- a/README.md
+++ b/README.md
@@ -46,6 +46,19 @@ graph LR
 
 The concept index includes **aliases** (abbreviations, acronyms, synonyms) generated by the LLM at ingestion time. Searching "CDX" matches the alias on "CycloneDX"; searching "SBOM" matches "Software Bill of Materials". This turns misses into hits without any runtime cost.
 
+<p align="center">
+  <img src="assets/demo_proactive_query.png" alt="AgentLib proactive library query" width="800">
+</p>
+
+*The agent automatically consults the knowledge library when it detects a domain-specific question — no explicit command needed.*
+
+<details>
+<summary>Expanded: how the library-researcher navigates</summary>
+<p align="center">
+  <img src="assets/demo_library_researcher.png" alt="Library researcher agent navigation" width="800">
+</p>
+</details>
+
 ### Three metadata layers
 
 ```
diff --git a/assets/demo_library_researcher.png b/assets/demo_library_researcher.png
new file mode 100644
index 0000000..ac823b9
Binary files /dev/null and b/assets/demo_library_researcher.png differ
diff --git a/assets/demo_proactive_query.png b/assets/demo_proactive_query.png
new file mode 100644
index 0000000..057dea4
Binary files /dev/null and b/assets/demo_proactive_query.png differ
diff --git a/skills/agentlib-knowledge/SKILL.md b/skills/agentlib-knowledge/SKILL.md
index 24f4ebe..7e86f33 100644
--- a/skills/agentlib-knowledge/SKILL.md
+++ b/skills/agentlib-knowledge/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: agentlib-knowledge
-description: "Knowledge library navigation. Trigger on: research questions, book references, domain knowledge queries, 'according to', 'what does the book say', 'look up', 'find in', or any question that may be answered by ingested books/documents/papers. Do NOT trigger on: code editing, git operations, file management, web browsing requests."
+description: "Knowledge library navigation. Trigger on: research questions, book references, domain knowledge queries, 'according to', 'what does the book say', 'look up', 'find in', or any question that may be answered by ingested books/documents/papers. Also trigger when: writing code that involves domain-specific parameters, protocols, standards, or configurations; encountering technical terms that might be defined in the library; the user asks about methodology, best practices, or procedures from a specific domain. Do NOT trigger on: general programming tasks (loops, data structures, algorithms), git operations, file management, web browsing requests."
 ---
 
 ## AgentLib — Knowledge Library