$npx -y skills add davidliuk/graph-of-skills --skill vector-skills-retrieverRetrieve a bounded bundle of relevant external skills from the local skill workspace using vector embedding similarity only.
| 1 | # Purpose |
| 2 | |
| 3 | Use this skill when the task likely needs specialized domain knowledge, scripts, or references that are not already obvious from the current context. |
| 4 | |
| 5 | This retriever uses embedding similarity only. It does not use graph edges, graph propagation, or lexical expansion. |
| 6 | |
| 7 | # Retrieve Relevant Skills |
| 8 | |
| 9 | Run: |
| 10 | |
| 11 | ```bash |
| 12 | OPENROUTER_API_KEY="${OPENROUTER_API_KEY:-$OPENAI_API_KEY}" \ |
| 13 | OPENAI_API_KEY="${OPENROUTER_API_KEY:-$OPENAI_API_KEY}" \ |
| 14 | OPENAI_BASE_URL=https://openrouter.ai/api/v1 \ |
| 15 | GOS_EMBEDDING_MODEL=openai/text-embedding-3-large \ |
| 16 | GOS_EMBEDDING_DIM=3072 \ |
| 17 | vectorskills-query "short description of the task or current subproblem" |
| 18 | ``` |
| 19 | |
| 20 | Diagnostic rule: do not suppress stderr and do not replace failures with fallback text. If `vectorskills-query` fails, keep the original stderr visible and note the real exit code so the failure remains diagnosable. |
| 21 | |
| 22 | Useful flags: |
| 23 | |
| 24 | ```bash |
| 25 | vectorskills-query "debug spring boot jakarta migration build errors" --top-n 5 --max-context-chars 9000 |
| 26 | vectorskills-query "extract text from receipts into xlsx" --json |
| 27 | ``` |
| 28 | |
| 29 | # How To Use The Results |
| 30 | |
| 31 | 1. Start with a short task-level query. |
| 32 | 2. Read the returned skill bundle. |
| 33 | 3. Follow the retrieved skill instructions and inspect any referenced files under `/opt/graphskills/skills/<skill-name>/`. |
| 34 | 4. Re-query with a narrower subproblem if needed. |