swarmvault · swarmclawai/swarmclaw — скилл для Claude Code: что делает и как установить
Скилл для Claude Code и Codex. Задаёт правила работы с базой знаний SwarmVault через граф и компилятор — структурирует документы и связывает факты без слепого поиска по файлам.
MIT ★ 710 обновлён 2026-06-30
npx skills add swarmclawai/swarmclaw --skill swarmvault -a claude-codeЧто делает swarmvault
Скилл обучает агента работать с трёхслойным хранилищем SwarmVault. В папку raw/ складываются неизменяемые исходники вроде PDF или заметок. Каталог wiki/ содержит скомпилированные Markdown-страницы со служебными метаданными, а каталог state/ хранит индексы и граф связей. Контракт хранилища задаётся файлом swarmvault.schema.md.
Инструкция заставляет модель предпочитать запросы по графу обычному поиску через grep. Для поиска связей и зависимостей агент вызывает инструменты query_graph или blast_radius. Новые материалы добавляются через ingest_input, после чего запускается compile_vault. Без установленного npx или настроенного MCP-сервера @swarmvaultai/cli эти команды в окружении не сработают.
Регламент запрещает напрямую менять файлы в raw/, чтобы не ломать цепочку источников. Если схема хранилища изменилась, агент сначала выполняет проверку через lint_vault, и только потом компилирует базу. Удачные ответы переносятся в wiki/outputs/, превращаясь в часть базы знаний.
Какие задачи решает
- организовать трёхслойную базу знаний с разделением сырых данных и скомпилированных заметок
- находить связи и зависимости между документами через граф, а не слепой поиск
- добавлять новые файлы в хранилище через
ingest_inputбез изменения исходников - контролировать целостность метаданных страниц и схемы хранилища с помощью
lint_vault
Примеры запросов агенту
- Проверь граф в
wiki/graph/report.mdи покажи, от каких модулей зависит страницаwiki/concepts/auth.md - Добавь новый PDF-документ через
ingest_inputи пересобери хранилище с помощьюcompile_vault - Найди через
query_vaultкратчайший путь между узламиAPIиDatabaseи сохрани ответ вwiki/outputs/
Как установить swarmvault
1Через Skills CLI (Vercel)
npx skills add swarmclawai/swarmclaw --skill swarmvault -a claude-code2Вручную: положить файлы
~/.claude/skills/swarmvault/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/swarmvault/
1Через Skills CLI (Vercel)
npx skills add swarmclawai/swarmclaw --skill swarmvault -a codex2Вручную: положить файлы
.agents/skills/swarmvault/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add swarmclawai/swarmclaw --skill swarmvault -a cursor2Вручную: положить файлы
.cursor/skills/swarmvault/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install swarmclawai/swarmclaw skills/swarmvault2Вручную: положить файлы
.github/skills/swarmvault/SKILL.md1Через Skills CLI (Vercel)
npx skills add swarmclawai/swarmclaw --skill swarmvault -a gemini-cli2Командой платформы
gemini skills install https://github.com/swarmclawai/swarmclaw --path skills/swarmvaultВручную: положить файлы
.devin/skills/swarmvault/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add swarmclawai/swarmclaw --skill swarmvault -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о swarmvault
Как установить swarmvault в Claude Code?
Запустите команду npx skills add swarmclawai/swarmclaw --skill swarmvault -a claude-code. Файл навыка запишется в каталог ~/.claude/skills/swarmvault/SKILL.md.
Что делает скилл swarmvault?
Скилл обучает агента регламенту работы с хранилищем SwarmVault. Он запрещает напрямую менять файлы в raw/, требует сохранять метаданные в wiki/ и направляет модель использовать граф связей вместо текстового поиска.
Что необходимо для работы swarmvault?
Требуется установленный бинарник npx и запущенный MCP-сервер SwarmVault через команду npx -y @swarmvaultai/cli mcp. Если сервер недоступен, агенту понадобится доступ к командной строке для прямого вызова CLI.
Исходный текст
SKILL.md · MIT
---
name: swarmvault
description: Use when working with a SwarmVault knowledge vault (raw/, wiki/, swarmvault.schema.md). Establishes schema-first conventions and prefers graph queries over broad search.
homepage: https://swarmvault.ai
metadata:
openclaw:
capabilities: [knowledge-base, knowledge-graph, retrieval, vault]
requires:
bins: [npx]
---
# SwarmVault
Use when the agent has a SwarmVault MCP server enabled (transport `stdio`, command `npx -y @swarmvaultai/cli mcp`) pointed at a vault directory.
A SwarmVault workspace is a three-layer knowledge system:
- `raw/` — immutable source inputs (PDFs, transcripts, code, emails, URLs, sheets). Never edit.
- `wiki/` — generated markdown owned by the agent and the SwarmVault compiler. Pages carry frontmatter (`page_id`, `source_ids`, `node_ids`, `freshness`, `source_hashes`).
- `state/` — generated indexes, graphs, and approvals. Treat as opaque output of `compile`.
The vault contract lives in `swarmvault.schema.md` at the workspace root. The vault config lives in `swarmvault.config.json`.
## Rules
1. **Read `swarmvault.schema.md` first** before any compile or query work. It defines categories, naming, freshness rules, and grounding conventions for this specific vault.
2. **Read `wiki/graph/report.md` before broad file searching** when it exists; otherwise start with `wiki/index.md`. Both summarize the vault structure so you don't re-scan everything.
3. **Treat `raw/` as immutable.** Never edit, rename, or delete files there. New sources go through `ingest`.
4. **Treat `wiki/` as compiler-owned.** Edits should preserve frontmatter fields exactly: `page_id`, `source_ids`, `node_ids`, `freshness`, `source_hashes`. If those drift, the next `compile` will overwrite or flag the page.
5. **Prefer graph queries over grep/glob** for "how does X relate to Y" or "what depends on Z" questions. The vault's typed graph is more reliable than text search.
6. **Save high-value answers** to `wiki/outputs/` (use the `query` or `explore` tools) instead of leaving them only in chat. That way they become first-class vault content for next time.
## Tool Palette
The SwarmVault MCP server exposes the following tools (names are prefixed by SwarmClaw with `mcp_<sanitized server name>_`, e.g. `mcp_SwarmVault_query_vault`). Match the user's intent to the closest tool:
Vault inspection:
- `workspace_info` — return current vault paths and high-level counts. Use this first when you've never seen this vault.
- `list_sources` — list source manifests under `raw/`.
- `search_pages` — full-text search across compiled wiki pages.
- `read_page` — read a specific wiki page by its `wiki/`-relative path.
Graph (prefer over grep for relational questions):
- `graph_report` — machine-readable graph report and trust artifact. Read this before broad searching.
- `query_graph` — traverse the graph from search seeds without calling an LLM provider.
- `get_node` — explain a graph node, its page, community, neighbors, and group patterns.
- `get_neighbors` — neighbors of a node or page target.
- `get_hyperedges` — list graph hyperedges, optionally filtered.
- `shortest_path` — shortest path between two graph targets.
- `god_nodes` — highest-connectivity nodes (the vault's hubs).
- `blast_radius` — impact analysis: what depends on this file or module?
Question answering:
- `query_vault` — natural-language question against the vault. Returns grounded citations. Pass `save: true` to persist the answer to `wiki/outputs/`.
Ingest and maintenance:
- `ingest_input` — add a file path or URL to `raw/` and register it as a managed source.
- `compile_vault` — re-derive `wiki/` pages, graph, and search index. Run after ingest, after schema changes, or when freshness is stale.
- `lint_vault` — anti-drift and vault health checks.
If the MCP server is unavailable but the agent has a `shell` or `execute` tool, the same operations are available via `swarmvault <subcommand>` (or `npx -y @swarmvaultai/cli <subcommand>`) with the working directory set to the vault root.
## Workflow
For a fresh question against the vault:
1. Call `workspace_info` if you haven't already, then read `swarmvault.schema.md`. If `wiki/graph/report.md` or `wiki/index.md` exists, skim it.
2. Use `query_vault` (or `query_graph` / `get_node` / `shortest_path` for relational questions). Cite returned `source_ids` and `node_ids`.
3. If the answer reveals a gap, propose `ingest_input` for the missing source, then `compile_vault`.
4. Save the final answer with `query_vault` `save: true` so it becomes vault content under `wiki/outputs/`.
For a new source the user mentions:
1. `ingest_input` the file/URL.
2. `compile_vault` to derive new wiki pages, graph, and search index.
3. `lint_vault` to check frontmatter and links.
4. Skim the new pages in `wiki/sources/` and confirm provenance.
## Boundaries
- Don't run `compile` against an unreviewed change to `swarmvault.schema.md` — `lint` first.
- Don't promote candidate pages (`wiki/candidates/`) to `wiki/concepts/` or `wiki/entities/` without the user's confirmation; the approval flow exists for a reason.
- Don't push the vault graph to Neo4j or export to Obsidian without an explicit ask.
© swarmclawai · MIT · swarmclawai/swarmclaw
Похожие скиллы
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Сначала — swarmvault от других авторов.