Repolode
scaccogatto

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. 1

    Добавьте marketplace в Claude Code

    /plugin marketplace add scaccogatto/okf-skills
  2. 2

    Установите плагин okf

    /plugin install okf@scaccogatto
  3. 3

    Задокументируйте проект в OKF, попросив Claude создать bundle

    /okf:okf produce .okf
  4. 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.

16,2 тыс.+221 за неделю1,6 тыс.PythonMITАктивно поддерживаетсяОбновлён 11 дней назад

CLI и MCP-сервер, с помощью которого coding agents анализируют приложения, игры, бинарные файлы и сайты, а затем переносят их на Godot, Unity, Unreal или three.js.

18+1 за неделю3TypeScriptMITАктивно поддерживаетсяОбновлён 23 часа назад

Промпт-навык для AI-агентов, который помогает писать только необходимый для задачи код, отдавая предпочтение повторному использованию и минимальным решениям.

185,1 тыс.+5,1 тыс. за неделю10,2 тыс.JavaScriptMITОбновлён 8 дней назад