Стартовое хранилище, руководство, навыки и скрипты для AI-агента, который создаёт и поддерживает связанную базу знаний в Markdown в Claude Code и Obsidian.
scaccogatto/okf-skills
Набор инструментов для Claude Code, позволяющий создавать, проверять, визуализировать и сопровождать базы знаний OKF (Open Knowledge Format) в формате Markdown.
- Звёзды
- 438
- Форки
- 42
- Открытые issues
- 7
- Последний коммит
- позавчера
Что это?
OKF — открытый формат, не привязанный к конкретному вендору, для хранения сведений о системе в виде каталога Markdown-файлов с YAML frontmatter. Этот проект позволяет Claude Code в рамках обычного рабочего процесса создавать, сопровождать, использовать, проверять и визуализировать наборы данных OKF. В него входят детерминированный проверяющий инструмент для проверки соответствия спецификации, скрипт визуализации, который отображает набор данных в виде интерактивного графа, и навык backfill, восстанавливающий набор данных по истории git и расшифровкам сессий.
Набор инструментов распространяется через несколько каналов: плагин Claude Code, навыки агента, устанавливаемые через skills.sh, GitHub Action для проверки наборов данных в CI без агента и MCP-сервер только для чтения с инструментами поиска, чтения и поиска соседних узлов. В версии 0.2 формата добавлены поля provenance, trust и staleness; инструменты поддерживают их чтение и миграцию с v0.1.
Репозиторий распространяется по лицензии MIT и включает копию спецификации OKF v0.2, пример набора данных с работающей демоверсией, а также эксперименты с бенчмарками, их протоколы и результаты.
Ключевые возможности
- 01Создаёт и сопровождает наборы знаний OKF на основе включённой в репозиторий спецификации и шаблонов.
- 02Проверяет наборы данных на соответствие спецификации в строгом режиме и режиме с порогом предупреждений, а также поддерживает вывод в JSON.
- 03Отображает набор данных в виде автономного интерактивного HTML-графа с метками trust и staleness.
- 04Восстанавливает набор данных по истории git и расшифровкам сессий Claude.
- 05Предоставляет MCP-сервер только для чтения с инструментами поиска, чтения и поиска соседних узлов.
- 06Включает GitHub Action для проверки наборов данных в CI.
Сценарии использования
- Документирование архитектуры и решений сервиса в виде версионируемых Markdown-файлов рядом с кодом.
- Предоставление кодирующим агентам структурированного контекста проекта, который они могут читать и цитировать.
- Автоматическая проверка наборов знаний в CI перед слиянием изменений.
- Восстановление документации проекта для репозитория, в котором ещё нет набора знаний.
Быстрый старт
- 1
Добавьте marketplace в Claude Code
/plugin marketplace add scaccogatto/okf-skills - 2
Установите плагин okf
/plugin install okf@scaccogatto - 3
Задокументируйте проект в OKF, попросив Claude создать bundle
/okf:okf produce .okf - 4
Проверьте bundle перед коммитом
/okf:validate .okf --strict
Что важно знать
- Вся toolchain предназначена для Claude Code; другим агентам доступны только skills, без backfill subagents.
- Для работы скриптов нужен uv или python3 с установленным pyyaml.
- Проект ещё не достиг версии 1.0, поэтому тег действия @v1 может меняться от релиза к релизу.
В подборках
Темы
Частые вопросы
- Что такое okf-skills?
- Набор инструментов для Claude Code, позволяющий создавать, проверять, визуализировать и сопровождать базы знаний OKF (Open Knowledge Format) в формате Markdown. OKF — открытый формат, не привязанный к конкретному вендору, для хранения сведений о системе в виде каталога Markdown-файлов с YAML frontmatter. Этот проект позволяет Claude Code в рамках обычного рабочего процесса создавать, сопровождать, использовать, проверять и визуализировать наборы данных OKF. В него входят детерминированный проверяющий инструмент для проверки соответствия спецификации, скрипт визуализации, который отображает набор данных в виде интерактивного графа, и навык backfill, восстанавливающий набор данных по истории git и расшифровкам сессий.
- okf-skills можно использовать бесплатно? Какая у него лицензия?
- okf-skills распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- okf-skills всё ещё поддерживается?
- Активно поддерживается. Последний коммит в okf-skills — 4 нояб. 2026 г..
- Для чего можно использовать okf-skills?
- Документирование архитектуры и решений сервиса в виде версионируемых Markdown-файлов рядом с кодом. Предоставление кодирующим агентам структурированного контекста проекта, который они могут читать и цитировать. Автоматическая проверка наборов знаний в CI перед слиянием изменений. Восстановление документации проекта для репозитория, в котором ещё нет набора знаний.
- Как установить okf-skills?
- Добавьте marketplace в Claude Code: /plugin marketplace add scaccogatto/okf-skills Установите плагин okf: /plugin install okf@scaccogatto Задокументируйте проект в OKF, попросив Claude создать bundle: /okf:okf produce .okf Проверьте bundle перед коммитом: /okf:validate .okf --strict
- Где скачать okf-skills?
- Исходный код и инструкции по установке — на GitHub: https://github.com/scaccogatto/okf-skills
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
Второй мозг на базе ИИ для Obsidian: Claude Code читает материалы, связывает их и раскладывает по принадлежащему вам графу знаний в Markdown.
Постоянная память для Claude Code, Codex и других AI-агентов в виде обычных Markdown-файлов в хранилище Obsidian.
Набор инструментов с доступом к MCP-серверу, навыками и плагинами для AI-агентов, которые помогают разрабатывать проекты на платформе Sanity.
CLI и MCP-сервер, с помощью которого coding agents анализируют приложения, игры, бинарные файлы и сайты, а затем переносят их на Godot, Unity, Unreal или three.js.
Промпт-навык для AI-агентов, который помогает писать только необходимый для задачи код, отдавая предпочтение повторному использованию и минимальным решениям.