К основному содержанию
скилл CX Codex

swarmvault · swarmclawai/swarmclaw — скилл для Claude Code: что делает и как установить

Скилл для Claude Code и Codex. Задаёт правила работы с базой знаний SwarmVault через граф и компилятор — структурирует документы и связывает факты без слепого поиска по файлам.

MIT ★ 710 обновлён 2026-06-30

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add swarmclawai/swarmclaw --skill swarmvault -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/swarmvault/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/swarmvault/

По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.

swarmvault swarmclawai Скилл swarmvault для Claude Code собирает локальную базу знаний из файлов, ссылок и репозиториев, ищет по ней и формирует контекст для агента. Сохраняет и обновляет источники. CX Codex +1 ★ 738звёзд репо healthcheck iurykrieger Скилл healthcheck для Claude Code проверяет целостность графа знаний, находит изолированные сущности и устаревшие заметки в режиме чтения. CX Codex +1 ★ 111звёзд репо obsidian-health Eugeniu Ghelbur Команда obsidian-health сканирует Obsidian-хранилище, ищет противоречия, пробелы в концепциях, устаревшие данные и проблемы структуры. Выводит результаты по уровню серьёзности. CX Codex +1 ★ 5 412звёзд репо obsidian Teknium (teknium1), Hermes Agent Читает, ищет, создаёт и редактирует заметки в хранилище Obsidian. CX Codex +1 503установок Stable Baseline stablebaseline MCP-сервер Stable Baseline для Claude Code подключает агента к базе знаний компании: документам, базам данных, графу знаний и 40+ типам диаграмм. Проектами можно управлять через диалог с ИИ. CX Codex +1 memory-notes basicmachines-co Скилл memory-notes обучает ассистента форматировать markdown-заметки для базы знаний Basic Memory с категориями, связями и временными метками. CX Codex +1 1 600установок memory-curate basicmachines-co Скилл memory-curate связывает разрозненные заметки в граф знаний Basic Memory. Скилл находит заметки-сироты, правит теги и собирает обзорные хаб-документы. CX Codex +1 1 500установок

Из того же набора10

Весь набор →
swarmclaw Скилл объясняет агенту возможности SwarmClaw: инструменты, память, делегирование, коннекторы и MCP. Нужен агентам, работающим внутри SwarmClaw. CX Codex +1 ★ 710звёзд репо resourceful-problem-solving Скилл resourceful-problem-solving учит ИИ-агента искать обходные пути для задач без подходящего инструмента: проверять другие скиллы, находить CLI-утилиты и писать собственные скрипты. CX Codex +1 ★ 710звёзд репо openai-image-gen Скилл openai-image-gen генерирует изображения через OpenAI Images API: GPT Image, DALL-E 3 и DALL-E 2. Собирает пакет картинок и HTML-галерею для просмотра. CX Codex +1 ★ 710звёзд репо nano-pdf Скилл для создания и правки PDF-файлов через консольную утилиту nano-pdf текстовыми инструкциями. CX Codex +1 ★ 710звёзд репо nano-banana-pro Скилл nano-banana-pro создаёт изображения через Gemini 3 Pro Image, редактирует один файл или объединяет несколько. Для работы нужен ключ Gemini API. CX Codex +1 ★ 710звёзд репо google-workspace Учит агента работать с Google Workspace через CLI gws: читать и изменять файлы Drive, документы, таблицы, письма, календарь и чаты. CX Codex +1 ★ 710звёзд репо github Управляет задачами, пулл-реквестами и CI-пайплайнами на GitHub через утилиту gh. Разбирает упавшие тесты и проверяет статус PR прямо в чате. CX Codex +1 ★ 710звёзд репо coding-agent Скилл coding-agent для Claude Code и Codex: берёт на себя работу над отдельным проектом, ревью PR и крупный рефакторинг — задачи с несколькими итерациями по файлам. CX Codex +1 ★ 710звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой