pi update

pi/.pi/agent/skills/opty/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: opty
+description: Semantic code search using HDC (Hyperdimensional Computing). Finds functions, types, imports, and variables in the indexed codebase by meaning. Use when searching for code by concept — e.g. "error handling functions", "database types", "authentication flow".
+compatibility: Requires opty CLI and a running daemon. Install from source or binary.
+allowed-tools: Bash(opty:*)
+---
+
+# Opty — HDC Code Search
+
+Semantic code search via Hyperdimensional Computing. Indexes the codebase and finds relevant functions, types, and imports by meaning rather than exact text. The daemon auto-starts when you run any opty command.
+
+## Query
+
+```bash
+opty query "natural language description of what you're looking for"
+```
+
+Output is TOON format — compact, LLM-optimized:
+```
+functions[N]{name,signature,file,line}:
+functionName,signature,path/to/file.ts,42
+...
+```
+
+## Other Commands
+
+```bash
+opty status       # Show indexed file/unit count and watched directory
+opty reindex      # Force re-scan after major file changes or stale results
+```
+
+## Tips
+
+- Query by concept, not exact names: `"connection pool exhaustion"` not `"ConnectionPoolError"`
+- Results include file + line number — use `read` to get the actual code
+- `opty status` shows which directory is indexed (the daemon is per-project)
+- After large refactors, run `opty reindex` if results seem stale