feat: proactive library usage for domain-specific coding tasks

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
 
 ```

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