knowledge-graph — скилл для Claude Code: память и установка
Скилл knowledge-graph сохраняет устойчивые факты о людях, компаниях и проектах в графе знаний. Он пригодится, когда нужно переносить контекст между сессиями и находить его без просмотра длинных переписок.
MIT ★ 239 обновлён 2026-08-30
npx skills add jdrhyne/agent-skills --skill knowledge-graph -a claude-codeЧто делает knowledge-graph
Скилл извлекает долговечные факты из недавних заметок и разговоров, раскладывает их по сущностям и добавляет в facts.jsonl. Для каждой сущности он хранит краткий актуальный снимок в summary.md; при еженедельной сводке обновляет его по активным фактам. Историю скилл не переписывает: устаревшие записи помечает как заменённые.
Граф находится в life/areas/ и разделён на каталоги людей, компаний и проектов. Начальные папки создаются командой mkdir -p life/areas/people life/areas/companies life/areas/projects. При поиске скилл сначала читает сводку, а подробные факты открывает по запросу или если сводка устарела. Он не загружает граф в каждый разговор автоматически и не сохраняет секреты или чувствительные личные данные без явной просьбы пользователя.
Какие задачи решает
- сохранить важные факты из недавнего разговора
- разнести контекст по людям, компаниям и проектам
- обновить сводки по активным фактам за неделю
- найти известное о сущности без чтения длинных переписок
Примеры запросов агенту
- Сохрани из недавнего разговора устойчивые факты о проекте Atlas и добавь их в граф знаний.
- Обнови недельные сводки для людей и компаний, о которых появились новые факты.
- Что граф знаний хранит о проекте Atlas? Покажи подробности, если они есть.
Как установить knowledge-graph
1Через Skills CLI (Vercel)
npx skills add jdrhyne/agent-skills --skill knowledge-graph -a claude-code2Вручную: положить файлы
~/.claude/skills/knowledge-graph/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/knowledge-graph/
1Через Skills CLI (Vercel)
npx skills add jdrhyne/agent-skills --skill knowledge-graph -a codex2Вручную: положить файлы
.agents/skills/knowledge-graph/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jdrhyne/agent-skills --skill knowledge-graph -a cursor2Вручную: положить файлы
.cursor/skills/knowledge-graph/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jdrhyne/agent-skills clawdbot/knowledge-graph/SKILL.md2Вручную: положить файлы
.github/skills/knowledge-graph/SKILL.md1Через Skills CLI (Vercel)
npx skills add jdrhyne/agent-skills --skill knowledge-graph -a gemini-cli2Командой платформы
gemini skills install https://github.com/jdrhyne/agent-skills --path clawdbot/knowledge-graphВручную: положить файлы
.devin/skills/knowledge-graph/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о knowledge-graph
Как установить knowledge-graph в Claude Code?
Выполните npx skills add jdrhyne/agent-skills --skill knowledge-graph -a claude-code. Файл скилла находится по пути ~/.claude/skills/knowledge-graph/SKILL.md.
Что делает скилл knowledge-graph?
Он сохраняет устойчивые факты о людях, компаниях и проектах в графе знаний, а затем формирует краткие сводки по активным записям.
Как knowledge-graph хранит изменения фактов?
Новые факты добавляются в facts.jsonl, а устаревшие помечаются заменёнными, а не удаляются. Краткая сводка сущности хранится отдельно в summary.md.
Исходный текст
SKILL.md · MIT
---
name: knowledge-graph
description: Three-Layer Memory System — automatic fact extraction, entity-based knowledge graph, and weekly synthesis. Manages life/areas/ entities with atomic facts and living summaries.
metadata: {"version":"1.1.0","openclaw":{"emoji":"🧠"}}
permissions:
- exec: "Uses local filesystem commands when creating entity folders or scheduled knowledge-graph jobs."
- file_write: "Appends facts, summaries, and daily-note synthesis inside the workspace knowledge graph."
---
# Knowledge Graph Skill
Maintain a lightweight, append-only entity graph that compounds durable facts across sessions.
## When to Use
- Extract durable facts from recent work or conversation history
- Rewrite entity summaries from active facts
- Answer "what do we know about X?" without reopening large transcripts
- Keep shared context for people, companies, and projects inside the workspace
## Data Model
Store the graph under:
```text
<workspace>/life/areas/
people/<slug>/
companies/<slug>/
projects/<slug>/
```
Each entity folder should contain:
- `summary.md` for the short, current snapshot
- `facts.jsonl` for atomic, append-only facts
Use one JSON object per line:
```json
{
"id": "<slug>-NNN",
"fact": "Plain-English fact",
"category": "relationship|milestone|status|preference|context|decision",
"ts": "YYYY-MM-DD",
"source": "conversation|manual|inference",
"status": "active|superseded",
"supersedes": "<older-id>"
}
```
## Fact Rules
- Keep facts atomic. One durable fact per entry.
- Append new facts instead of rewriting history.
- When something changes, add a new fact and mark the old one as superseded.
- Skip ephemera, greetings, speculation, and low-value chatter.
- Check existing facts before adding duplicates.
Durable facts usually include:
- role or relationship changes
- key decisions
- long-lived preferences
- major project milestones
- stable operating context
## Workflows
### Fact Extraction
1. Read the recent daily note and the recent conversation window.
2. Identify durable facts worth preserving.
3. Resolve entity type and slug.
4. Create the entity folder if it does not exist.
5. Append new facts to `facts.jsonl`.
6. Note extraction activity in the daily note if the workspace uses one.
### Weekly Synthesis
1. List entities changed during the week.
2. Load active facts only.
3. Rewrite `summary.md` in 3 to 8 concise lines.
4. Ensure contradicted facts are marked superseded.
5. Record a short synthesis note in the daily log if applicable.
### Entity Lookup
1. Read `summary.md` first.
2. Open `facts.jsonl` only if the summary is stale or the user asked for detail.
3. Fall back to broader memory search only when the entity is missing from the graph.
## Low-Token Recall
Recall should be triggered, not automatic.
- Recall when the user names a tracked person, company, or project.
- Recall when the user explicitly asks to remember, recall, or summarize prior context.
- Inject only the short summary by default.
- Avoid loading raw facts unless the user asked for specifics or contradictions need resolution.
## Setup
Create the core directories once:
```bash
mkdir -p life/areas/people life/areas/companies life/areas/projects
```
If multiple agents share one workspace, point them at the same `life/` directory so they operate on the same entity store.
## Safety Boundaries
- Do not store sensitive secrets, credentials, or highly personal data unless the user explicitly asked for it.
- Do not create entities or facts for casual chat that has no durable value.
- Do not inject the graph into every conversation by default.
- Do not delete historical facts; supersede them with a newer fact instead.
© jdrhyne · MIT · jdrhyne/agent-skills