kb — скилл для Claude Code: что делает и как установить
Скилл-хаб для организации памяти ассистента в формате OKF. Помогает структурировать базу знаний репозитория и направляет запросы к специализированным скиллам семейства kb.
npx skills add stjbrown/agent-knowledge --skill kb -a claude-codeЧто делает kb
Скилл выступает диспетчером и хранилищем стандартов для семейства kb-*. Сам по себе kb не меняет файлы, а распределяет задачи: запуск новой базы знаний отдаёт kb-init, поиск с цитированием — kb-query, разбор внешних заметок и ссылок — kb-ingest, а документирование кода — kb-document. Если в проекте уже есть папка knowledge/, скилл предписывает обращаться к ней до того, как отвечать на задачу с нуля.
Внутри собраны спецификация OKF v0.2, глоссарий, правила доверия к источникам и шаблоны заметок (concept.md, index.md, log.md). Жёсткое правило одно: каждый пользовательский файл .md обязан содержать парсируемый YAML frontmatter с непустым полем type. Остальные поля опциональны, поэтому ассистент не должен браковать заметки из-за неизвестных типов или сломанных ссылок.
Какие задачи решает
- организовать локальную базу знаний проекта в формате OKF
- маршрутизировать задачи между специализированными скиллами семейства kb
- проверять соответствие структуры заметок обязательному правилу YAML frontmatter
- зафиксировать единый глоссарий и шаблоны заметок для агентов
Примеры запросов агенту
- Проверь по базе знаний в
knowledge/, какие соглашения действуют для архитектуры API - Подскажи, какой скилл из линейки kb запустить для обработки новой статьи
- Инициализируй документацию репозитория по правилам спецификации OKF
Как установить kb
1Через Skills CLI (Vercel)
npx skills add stjbrown/agent-knowledge --skill kb -a claude-code2Вручную: положить файлы
~/.claude/skills/kb/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/kb/
1Через Skills CLI (Vercel)
npx skills add stjbrown/agent-knowledge --skill kb -a codex2Вручную: положить файлы
.agents/skills/kb/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add stjbrown/agent-knowledge --skill kb -a cursor2Вручную: положить файлы
.cursor/skills/kb/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install stjbrown/agent-knowledge kb2Вручную: положить файлы
.github/skills/kb/SKILL.md1Через Skills CLI (Vercel)
npx skills add stjbrown/agent-knowledge --skill kb -a gemini-cli2Командой платформы
gemini skills install https://github.com/stjbrown/agent-knowledge --path skills/kbВручную: положить файлы
.devin/skills/kb/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add stjbrown/agent-knowledge --skill kb -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о kb
Как установить kb в Claude Code?
Выполните в терминале команду npx skills add stjbrown/agent-knowledge --skill kb -a claude-code. Конфигурация сохранится в файле ~/.claude/skills/kb/SKILL.md.
Что делает скилл kb?
Это центральный хаб и справочник для работы с пакетами знаний OKF. Он хранит спецификацию, шаблоны и передаёт задачи профильным инструментам линейки вроде kb-query или kb-lint.
Какое главное требование к файлам в папке knowledge/?
Единственное строгое правило — каждый нерезервный файл .md должен содержать корректный YAML frontmatter с непустым полем type. Неизвестные типы или битые ссылки не должны приводить к отказу.
Исходный текст
SKILL.md · MIT
--- name: kb description: >- Portable OKF knowledge bundle for coding-agent memory and LLM wikis. Use when the user wants to start a wiki, ingest a source, document a repository, query project knowledge with citations, lint for drift, or visualize connections; whenever a repo has a knowledge/ bundle that should inform the task; and when another kb-* skill needs the shared spec, glossary, templates, or trust model. version: 0.3.2 tags: [knowledge, okf, bundle, hub] --- # kb — bundles **Hub** for the `kb-*` family: vocabulary, shared reference, routing. Knowledge **compounds** — compiled once, kept current, not re-derived per query. Does not modify a bundle — routes to the skill that does. ## Key terms [references/glossary.md](references/glossary.md) defines the vocabulary. Minimum before routing: **Bundle**, **Ingest**, **Progressive disclosure**, **Trust model** (see [trust-model.md](references/trust-model.md)). ## The one hard rule A bundle is **conformant** iff every non-reserved `.md` file has parseable YAML frontmatter with a non-empty `type`. Everything else is soft guidance — consumers MUST tolerate missing optional fields, unknown types, and broken links. Never reject a bundle over them. Full rules: [references/SPEC.md](references/SPEC.md) §11. The domain portion of `spec/types.md` is a living, producer-chosen vocabulary, not a validation enum. Keep the workflow conventions `Reference` and `Spec Section`; start the domain types small and evolve them through [`kb-ingest`](../kb-ingest/SKILL.md) or [`kb-document`](../kb-document/SKILL.md) when the domain reveals a durable new kind of entity. Use [`kb-lint`](../kb-lint/SKILL.md) to detect schema drift. ## Route to the right skill | The user wants to… | Use | |---|---| | Start a new bundle | [`kb-init`](../kb-init/SKILL.md) | | Capture, ingest, file, or process a source (note, transcript, PDF, image, URL) | [`kb-ingest`](../kb-ingest/SKILL.md) | | Document a repository, explain its architecture/workflows, or refresh knowledge after code changes | [`kb-document`](../kb-document/SKILL.md) | | Ask what the bundle knows; look something up; explore connections | [`kb-query`](../kb-query/SKILL.md) | | Health-check the bundle (**drift**, orphans, contradictions, conformance) | [`kb-lint`](../kb-lint/SKILL.md) | | See the bundle as a graph | [`kb-visualize`](../kb-visualize/SKILL.md) | If a `knowledge/` bundle exists and would inform the current task, consult it via [`kb-query`](../kb-query/SKILL.md) before answering from scratch — even when the user didn't ask an explicit knowledge question. ## Shared reference (single source of truth) Every `kb-*` skill reads these rather than restating them, so the family stays consistent: - [references/SPEC.md](references/SPEC.md) — OKF v0.2, vendored verbatim. - [references/version-profile.md](references/version-profile.md) — v0.2 production and v0.1 compatibility rules; every writing skill reads it before changing a bundle. - [references/glossary.md](references/glossary.md) — leading words and definitions. - [references/trust-model.md](references/trust-model.md) — the maintenance rules. - [templates/](templates/) — `concept.md`, `index.md`, `log.md` starters. - [example-bundle/](example-bundle/) — a tiny conformant bundle: a worked example, and the seed `kb-init` copies from.
© stjbrown · MIT · stjbrown/agent-knowledge
