@jayjiang/byoao 0.8.0 → 0.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jayjiang/byoao",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Build Your Own AI OS — Obsidian + AI Agent",
   "type": "module",
   "engines": {

package/src/skills/challenge.md

@@ -1,6 +1,6 @@
 ---
 name: challenge
-description: Pressure-test a belief, assumption, or decision using the vault's own history. Finds counter-evidence, contradictions, and blind spots.
+description: Pressure-test a belief, assumption, or decision using the vault's own history. Finds counter-evidence, contradictions, and blind spots. Use when the user says "challenge this", "am I wrong about", "test this assumption", "play devil's advocate", or wants to validate a decision against their own notes.
 ---
 
 # /challenge — Pressure-Test Your Thinking

package/src/skills/connect.md

@@ -1,6 +1,6 @@
 ---
 name: connect
-description: Bridge two seemingly unrelated topics or domains using the vault's link graph. Discovers hidden paths and shared contexts between concepts.
+description: Bridge two seemingly unrelated topics or domains using the vault's link graph. Discovers hidden paths and shared contexts. Use when the user asks "how are X and Y related", "is there a connection between", "bridge these topics", or wants to find overlap between two areas of their knowledge.
 ---
 
 # /connect — Bridge Two Domains

package/src/skills/diagnose.md

@@ -1,6 +1,6 @@
 ---
 name: diagnose
-description: Diagnose knowledge graph health — find missing frontmatter, orphan notes, broken wikilinks, and AGENT.md drift. Suggests fixes and asks for confirmation before making changes.
+description: Diagnose knowledge graph health — find missing frontmatter, orphan notes, broken wikilinks, and AGENT.md drift. Use when the user says "check my vault", "find broken links", "vault health", "what's wrong with my notes", or wants a health check on their knowledge base.
 ---
 
 # /diagnose — Knowledge Graph Health Check

package/src/skills/drift.md

@@ -1,6 +1,6 @@
 ---
 name: drift
-description: Compare stated intentions vs actual behavior over 30-60 days using daily notes and project documents. Reveals where actions diverge from plans.
+description: Compare stated intentions vs actual behavior over 30-60 days using daily notes and project documents. Use when the user asks "am I doing what I said I would", "what happened to my goals", "where did my time go", "check my follow-through", or wants to reflect on alignment between plans and actions.
 ---
 
 # /drift — Detect Intention-Action Gaps

package/src/skills/emerge.md

@@ -1,6 +1,6 @@
 ---
 name: emerge
-description: Surface conclusions, patterns, and insights the vault implies but never explicitly states. Analyzes clusters, orphans, and cross-domain connections.
+description: Surface conclusions, patterns, and insights the vault implies but never explicitly states. Analyzes clusters, orphans, and cross-domain connections. Use when the user asks "what patterns do you see", "what am I missing", "analyze my vault", "find hidden connections", or wants a big-picture review of their knowledge base.
 ---
 
 # /emerge — Surface Hidden Patterns
@@ -43,9 +43,7 @@ Identify:
 Use graph-level queries to identify interesting patterns:
 
 **Orphan notes** — notes with no links in or out:
-```bash
-obsidian search -orphans
-```
+Use `byoao_graph_health` or scan notes checking for those with zero wikilinks (no `[[` in content) and zero backlinks.
 Orphans may contain ideas the user hasn't connected yet.
 
 **Dead-end notes** — notes that link out but nobody links to them:

package/src/skills/explain.md

@@ -1,6 +1,6 @@
 ---
 name: explain
-description: Explain codebase systems and workflows in clear, non-jargon language. Uses engineer-generated overviews as baseline, reads local repo clones for details, caches knowledge in Obsidian vault.
+description: Explain codebase systems and workflows in clear, non-jargon language, cached in the Obsidian vault. Use when the user asks "how does this system work", "explain the architecture", "what does this service do", or needs a plain-language explanation of any codebase or technical system.
 ---
 
 # /explain — System Explainer

package/src/skills/ideas.md

@@ -1,6 +1,6 @@
 ---
 name: ideas
-description: Deep vault scan to generate actionable ideas by combining insights across domains, finding gaps, and proposing concrete next steps.
+description: Deep vault scan to generate actionable ideas by combining insights across domains, finding gaps, and proposing concrete next steps. Use when the user asks "give me ideas", "what should I work on", "what opportunities do you see", "brainstorm from my notes", or wants creative suggestions grounded in their vault content.
 ---
 
 # /ideas — Generate Actionable Ideas

package/src/skills/trace.md

@@ -1,6 +1,6 @@
 ---
 name: trace
-description: Track how an idea, concept, or topic evolved across the vault over time. Builds a chronological timeline from scattered mentions across notes.
+description: Track how an idea, concept, or topic evolved across the vault over time. Builds a chronological timeline from scattered mentions. Use when the user asks "how did X evolve", "what's the history of", "when did we start thinking about", "trace this idea", or wants to understand the arc of a concept.
 ---
 
 # /trace — Track Idea Evolution

package/src/skills/weave.md

@@ -1,6 +1,6 @@
 ---
 name: weave
-description: Scan vault notes, enrich with frontmatter + wikilinks, maintain the Glossary, create hub notes — building a connected knowledge graph.
+description: Scan vault notes, enrich with frontmatter + wikilinks, maintain the Glossary, create hub notes — building a connected knowledge graph. Use when the user says "connect my notes", "add links", "enrich", "organize my vault", "run weave", or after importing new files into the vault.
 ---
 
 # /weave — Connect Your Notes