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

graph-skills-retriever

GitHub

通过graphskills-query命令从本地库检索相关技能包，避免手动浏览。适用于需要特定领域知识、脚本或参考但未在上下文中明确的任务场景，支持按子问题迭代查询。

evaluation/skillsbench/graphskills_assets/bootstrap_skill/SKILL.md davidliuk/graph-of-skills

Trigger Scenarios

任务需要外部专业知识但上下文不足需查找特定脚本或参考资料面对庞大技能库需精准定位

Install

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

More Options

Non-standard path

npx skills add https://github.com/davidliuk/graph-of-skills/tree/main/evaluation/skillsbench/graphskills_assets/bootstrap_skill -g -y

Use without installing

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

指定 Agent (Claude Code)

npx skills add davidliuk/graph-of-skills --skill graph-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": "graph-skills-retriever",
    "inputs": [
        "task description or subproblem summary"
    ],
    "outputs": [
        "a ranked skill bundle with full instructions and source paths under \/opt\/graphskills\/library"
    ],
    "description": "Retrieve a bounded bundle of relevant external skills from the local Graph Skills library instead of manually browsing hundreds of skills.",
    "allowed-tools": [
        "shell",
        "python3"
    ],
    "compatibility": [
        "claude-code",
        "codex",
        "gemini-cli"
    ]
}

Purpose

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

The full skill library is stored outside the auto-loaded harness context at:

/opt/graphskills/library

Do not manually scan that whole directory first. Retrieve a focused bundle.

Retrieve Relevant Skills

Run:

graphskills-query "short description of the task or current subproblem"

Useful flags:

graphskills-query "debug spring boot jakarta migration build errors" --top-n 5 --seed-top-k 4 --max-context-chars 9000
graphskills-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 in /opt/graphskills/library/<skill-name>/.
Re-query with a narrower subproblem if needed.

Guidance

Prefer 1-2 retrieval calls over manually searching the entire library.
The returned Source: path points to the canonical SKILL.md in /opt/graphskills/library.
If you need scripts or references from a retrieved skill, inspect that skill directory directly.
Reuse the graph retriever whenever the task shifts to a new subproblem.