Skip to content
Skills Library
AI & agents · Analysis

knowledge_graph_skill

/knowledge_graph_skill

Skill for searching and evolving the SQLite-backed Knowledge Graph.\ \ Use this when you need structured fact/concept/link search across one or more\ \ teams, NPCs, or directory scopes.\nThe Knowledge Graph (KG) is stored in the application's\ \ database (not YAML). It is scoped by (team_name, npc_name, directory_path). Facts\ \ and concepts carry generation numbers and origin tags.\nSearch methods (choose\ \ the right one):\n1. Keyword search \u2014 fast substring match over fact statements.\n\ \ `kg_search_facts(engine_or_kg, \"keyword\")` \u2192 List[str]\n\n2. Embedding\ \ search \u2014 se

Repository
npcpy ↗
Licence
MIT
Last repository change
26.10.2026

Assessment and security

82/ 100Class: good
Format15 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability17 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: instruct.py

What it does and when to use it

Skill for searching and evolving the SQLite-backed Knowledge Graph.\ \ Use this when you need structured fact/concept/link search across one or more\ \ teams, NPCs, or directory scopes.\nThe Knowledge Graph (KG) is stored in the application's\ \ database (not YAML). It is scoped by (team_name, npc_name, directory_path). Facts\ \ and concepts carry generation numbers and origin tags.\nSearch methods (choose\ \ the right one):\n1. Keyword search \u2014 fast substring match over fact statements.\n\ \ `kg_search_facts(engine_or_kg, \"keyword\")` \u2192 List[str]\n\n2. Embedding\ \ search \u2014 se

Triggers from the description

keyword\
Original author description

Skill for searching and evolving the SQLite-backed Knowledge Graph.\ \ Use this when you need structured fact/concept/link search across one or more\ \ teams, NPCs, or directory scopes.\nThe Knowledge Graph (KG) is stored in the application's\ \ database (not YAML). It is scoped by (team_name, npc_name, directory_path). Facts\ \ and concepts carry generation numbers and origin tags.\nSearch methods (choose\ \ the right one):\n1. Keyword search \u2014 fast substring match over fact statements.\n\ \ `kg_search_facts(engine_or_kg, \"keyword\")` \u2192 List[str]\n\n2. Embedding\ \ search \u2014 se

How it works

  1. Inputs
  2. Steps
  3. Usage
Original SKILL.md headings · 51 lines, 320 words
SKILL.md preview
---
name: knowledge_graph_skill
description: "Skill for searching and evolving the SQLite-backed Knowledge Graph.\
  \ Use this when you need structured fact/concept/link search across one or more\
  \ teams, NPCs, or directory scopes.\nThe Knowledge Graph (KG) is stored in the application's\
  \ database (not YAML). It is scoped by (team_name, npc_name, directory_path). Facts\
  \ and concepts carry generation numbers and origin tags.\nSearch methods (choose\
  \ the right one):\n1. Keyword search \u2014 fast substring match over fact statements.\n\
  \   `kg_search_facts(engine_or_kg, \"keyword\")` \u2192 List[str]\n\n2. Embedding\
  \ search \u2014 semantic cosine similarity via vector embeddings.\n   `kg_embedding_search(engine_or_kg,\
  \ query=\"...\", embedding_model=\"nomic-embed-text\",\n    embedding_provider=\"\
  ollama\", similarity_threshold=0.6, max_results=20)`\n   \u2192 List[dict] with\
  \ 'content', 'type', 'score'\n\n3. Link search \u2014 graph traversal (BFS/DFS)\
  \ starting from keyword-matched seeds.\n   `kg_link_search(engine_or_kg, query=\"\
  ...\", max_depth=2, breadth_per_step=5,\n    strategy=\"bfs\", max_results=20)`\n\
  \   \u2192 List[dict] with 'content', 'type', 'depth', 'path', 'score'\n\n4. Hybrid\
  \ search \u2014 combines keyword + embedding + link, boosting results\n   found\
  \ by multiple methods.\n   `kg_hybrid_search(engine_or_kg, query=\"...\", mode=\"\
  all\", max_depth=2,\n    similarity_threshold=0.6, max_results=20)`\n   \u2192 List[dict]\
  \ with 'content', 'type', 'score', 'source'\n\nGraph evolution (use sparingly, usually\
  \ in background): - `kg_initial(content, model, provider)` \u2014 build a new KG\
  \ from text - `kg_evolve_incremental(existing_kg, new_content_text, ...)` \u2014\
  \ add content - `kg_sleep_process(existing_kg, model, provider)` \u2014 prune/deepen/consolidate\
  \ - `kg_dream_process(existing_kg, model, provider, num_seeds)` \u2014 speculative\
  \ synthesis\nWhen a user asks a question that spans facts, concepts, and their relationships,\
  \ prefer hybrid search. For pure semantic similarity without graph structure, use\
  \ embedding search. For exploring connected neighborhoods, use link search with\
  \ BFS."
---

# knowledge_graph_skill

Skill for searching and evolving the SQLite-backed Knowledge Graph. Use this when you need structured fact/concept/link search across one or more teams, NPCs, or directory scopes.
The Knowledge Graph (KG) is stored in the application's database (not YAML). It is scoped by (team_name, npc_name, directory_path). Facts and concepts carry generation numbers and origin tags.
Search methods (choose the right one):
1. Keyword search — fast substring match over fact statements.
   `kg_search_facts(engine_or_kg, "keyword")` → List[str]

2. Embedding search — semantic cosine similarity via vector embeddings.
   `kg_embedding_search(engine_or_kg, query="...", embedding_model="nomic-embed-text",
    embedding_provider="ollama", similarity_threshold=0.6, max_results=20)`
   → List[dict] with 'content', 'type', 'score'

3. Link search — graph traversal (BFS/DFS) starting from keyword-matched seeds.
   `kg_link_search(engine_or_kg, query="...", max_depth=2, breadth_per_step=5,
    strategy="bfs", max_results=20)`
   → List[dict] with 'content', 'type', 'depth', 'path', 'score'

4. Hybrid search — combines keyword + embedding + link, boosting results
   found by multiple methods.
   `kg_hybrid_search(engine_or_kg, query="...", mode="all", max_depth=2,
    similarity_threshold=0.6, max_results=20)`
   → List[dict] with 'content', 'type', 'score', 'source'

Graph evolution (use sparingly, usually in background): - `kg_initial(content, model, provider)` — build a new KG from text - `kg_evolve_incremental(existing_kg, new_content_text, ...)` — add content - `kg_sleep_process(existing_kg, model, provider)` — prune/deepen/consolidate - `kg_dream_process(existing_kg, model, provider, num_seeds)` — speculative synthesis
When a user asks a question that spans facts, concepts, and their relationships, prefer hybrid search. For pure semantic similarity without graph structure, use embedding search. For exploring connected neighborhoods, use link search with BFS.

## Inputs

- `name` (default: `'search_method'`)
- `description` (default: `'keyword | embedding | link | hybrid'`)
- `name` (default: `'query'`)
- `description` (default: `"The user's query or topic to search"`)
- `name` (default: `'scope_team'`)
- `description` (default: `'Team name to scope the search (optional)'`)
- `name` (default: `'scope_npc'`)
- `description` (default: `'NPC name to scope the search (optional)'`)
- `name` (default: `'scope_directory'`)
- `description` (default: `'Directory path to scope the search (optional)'`)

## Steps

- `instruct` → [`instruct.py`](./instruct.py)

## Usage

```
/run_jinx jinx_ref=knowledge_graph_skill input_values={"name": "scope_directory", "description": "Directory path to scope the search (optional)"}
```
Files in this package (2)
  • SKILL.md 5 KB
  • instruct.py 1 KB

Versions

The database has no other skills named knowledge_graph_skill.

Database snapshot: 13.11.2026 · package version a756e33eb56c (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 82knowledge_store_skill
    Skill for working with local .knowledge.yaml files via KnowledgeStore.\ \ Use this when you need to recall, search, or manage directory-local memories and\ \ knowledge links stored in plain YAML alongside the user's project files.\nKnowledgeStore\ \ is directory-scoped. Each…
  • 87using-agent-brain
    Expert Agent Brain skill for document search with BM25 keyword, semantic vector, hybrid, graph, and multi retrieval modes. Use when asked to "search documentation", "query domain", "find in docs", "bm25 search", "hybrid search", "semantic search", "graph search", "multi search",…
  • 100engram
    Persistent AI memory backend with semantic search and knowledge graph. Stores episodic, semantic, and procedural memories in a local SQLite database and retrieves the most relevant ones using vector similarity and graph traversal. Use when you need to remember information across…
  • 100knowledge-search
    Retrieval (RAG) over the local knowledge base. Use BEFORE searching the web, wikis or MCP tools whenever a question or task touches a domain, project, system, convention, decision or past experiment the user has worked on before ("how does X work here", "where is Y", "what did…
  • 100graph-build
    Builds or updates the code knowledge graph via tree-sitter AST and SQLite. Use when setting up the graph before search or blast-radius analysis.
  • 90memory
    Use when saving, recalling, correcting or forgetting facts about the owner, or designing keyword plus vector search and a link graph over personal notes.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.