Agent Skills › davidliuk/graph-of-skills › vector-skills-retriever

vector-skills-retriever

GitHub

通过向量嵌入相似度从本地技能工作区检索相关外部技能，辅助需要特定领域知识或脚本的任务。

skills/vector-skills-retriever/SKILL.md davidliuk/graph-of-skills

触发场景

任务需要未在上下文中明确的专业领域知识需要查找特定的参考脚本或文档

安装

npx skills add davidliuk/graph-of-skills --skill vector-skills-retriever -g -y

更多选项

不安装直接使用

npx skills use davidliuk/graph-of-skills@vector-skills-retriever

指定 Agent (Claude Code)

npx skills add davidliuk/graph-of-skills --skill vector-skills-retriever -a claude-code -g -y

安装 repo 全部 skill

npx skills add davidliuk/graph-of-skills --all -g -y

预览 repo 内 skill

npx skills add davidliuk/graph-of-skills --list

SKILL.md

Frontmatter

{
    "name": "vector-skills-retriever",
    "inputs": [
        "task description or subproblem summary"
    ],
    "outputs": [
        "a ranked skill bundle with full instructions and source paths under \/opt\/graphskills\/skills"
    ],
    "description": "Retrieve a bounded bundle of relevant external skills from the local skill workspace using vector embedding similarity only.",
    "allowed-tools": [
        "shell",
        "python3"
    ],
    "compatibility": [
        "claude-code",
        "codex",
        "gemini-cli"
    ]
}

Purpose

Use this skill when the task likely needs specialized domain knowledge, scripts, or references that are not already obvious from the current context.

This retriever uses embedding similarity only. It does not use graph edges, graph propagation, or lexical expansion.

Retrieve Relevant Skills

Run:

OPENROUTER_API_KEY="${OPENROUTER_API_KEY:-$OPENAI_API_KEY}" \
OPENAI_API_KEY="${OPENROUTER_API_KEY:-$OPENAI_API_KEY}" \
OPENAI_BASE_URL=https://openrouter.ai/api/v1 \
GOS_EMBEDDING_MODEL=openai/text-embedding-3-large \
GOS_EMBEDDING_DIM=3072 \
vectorskills-query "short description of the task or current subproblem"

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.

Useful flags:

vectorskills-query "debug spring boot jakarta migration build errors" --top-n 5 --max-context-chars 9000
vectorskills-query "extract text from receipts into xlsx" --json

How To Use The Results

Start with a short task-level query.
Read the returned skill bundle.
Follow the retrieved skill instructions and inspect any referenced files under /opt/graphskills/skills/<skill-name>/.
Re-query with a narrower subproblem if needed.