How davidliuk/graph-of-skills works
GoS turns a library of skill documents into a dependency-aware graph offline, then retrieves a small ranked bundle for an agent’s task. The engine is the central runtime: it coordinates parsing, graph construction and relinking, and online candidate retrieval/reranking. CLI, Claude Code, MCP, and evaluation-facing integrations expose that runtime. The README documents semantic and lexical seeding, merging, graph-aware reranking, and capped bundle output; sampled excerpts do not expose every internal call, so uncertain links are omitted.
Main entry points: engine.py Graph engine · cli.py Command-line interface · claude_code.py Claude Code interface · mcp.py MCP interface
Components 18
Skill inputs
- Skill library
Graph runtime
- Document parsing
gos/core/parsing.py - Skill schema
gos/core/schema.py - Graph engine
gos/core/engine.py - Directed graph storage
gos/core/storage.py - Dependency relinking
gos/core/relink.py - Skill retrieval
gos/core/retrieval.py - Extraction prompts
gos/core/prompts.py - LLM services
gos/core/litellm_services.py - Construction report
gos/core/construction_report.py - Runtime configuration
gos/utils/config.py
Agent interfaces
- Command-line interface
gos/interfaces/cli.py - Claude Code interface
gos/interfaces/claude_code.py - MCP interface
gos/interfaces/mcp.py - Agent skill runtime
evaluation/skill.py
Evaluation
- SkillsBench retrieval
evaluation/skillsbench/graphskills_assets/query.py - Retrieval ablations
evaluation/analysis/run_retrieval_ablation.py
Other components
- Agent
Connections 19
- Skill library → Graph engine: builds graph from
README.md - Agent → Command-line interface: requests skills
- Agent → Claude Code interface: requests skills
- Agent → MCP interface: requests skills
- Command-line interface → Graph engine: invokes
gos/interfaces/cli.py - Claude Code interface → Graph engine: invokes
gos/interfaces/claude_code.py - MCP interface → Graph engine: invokes
- Agent skill runtime → Graph engine: uses
evaluation/skill.py - Graph engine → Document parsing: parses skills
gos/core/engine.py - Graph engine → Skill schema: creates skill nodes
gos/core/engine.py - Graph engine → Directed graph storage: scores graph
gos/core/engine.py - Graph engine → Dependency relinking: relinks dependencies
gos/core/engine.py - Graph engine → Skill retrieval: retrieves candidates
gos/core/engine.py - Graph engine → Extraction prompts: uses prompts
gos/core/engine.py - Graph engine → LLM services: uses LLM services
gos/core/engine.py - Graph engine → Construction report: creates report
gos/core/engine.py - Graph engine → Runtime configuration: reads settings
gos/core/engine.py - Agent → SkillsBench retrieval: task query
- SkillsBench retrieval → Retrieval ablations: is evaluated by
evaluation/analysis/run_retrieval_ablation.py