Repolode
投稿する
scaccogatto

scaccogatto/okf-skills

OKF（Open Knowledge Format）の知識バンドルを作成・検証・可視化・保守するためのClaude Codeツールキット。

GitHub で見る公式サイト
スター
438
フォーク
42
未解決の Issue
7
最終コミット
一昨日

これは何？

OKFは、YAML frontmatter付きのMarkdownファイルをディレクトリにまとめ、システムに関する知識を保存するオープンかつベンダー中立のフォーマットです。このプロジェクトを使うと、Claude Codeの日常的なワークフローの中で、OKFバンドルを作成、保守、利用、検証、可視化できます。仕様への準拠を判定する決定論的なチェッカー、バンドルをインタラクティブなグラフとして表示するvizスクリプト、gitの履歴とセッションのトランスクリプトからバンドルを再構成するbackfillスキルが含まれています。

ツールキットは複数の方法で利用できます。Claude Codeプラグイン、skills.shからインストールできるagent skills、エージェントなしでCI上のバンドルを検証するGitHub Action、検索・読み取り・近傍検索ツールを備えた読み取り専用MCPサーバーを提供します。フォーマットのバージョン0.2ではprovenance、trust、stalenessの各フィールドが追加されており、ツールはこれらを読み取れるほか、v0.1からの移行にも対応しています。

リポジトリはMITライセンスで公開されており、同梱されたOKF v0.2仕様、ライブデモで公開されているサンプルバンドル、プロトコルと結果を含むベンチマーク実験を収録しています。

主な機能

  • 01同梱の仕様とテンプレートに基づいて、OKF知識バンドルを生成・保守します。
  • 02厳格モードや警告しきい値モード、JSON出力を使って、仕様に照らしてバンドルを検証します。
  • 03trustとstalenessのバッジ付きで、バンドルを自己完結型のインタラクティブなHTMLグラフとして表示します。
  • 04gitの履歴とClaudeセッションのトランスクリプトからバンドルを再構成します。
  • 05検索、読み取り、近傍検索ツールを提供する読み取り専用MCPサーバーを備えています。
  • 06CIでバンドルを検証するGitHub Actionを同梱しています。

ユースケース

  • サービスのアーキテクチャや意思決定を、コードとともにバージョン管理されたMarkdownで記録する。
  • コーディングエージェントに、読み取って引用できる構造化されたプロジェクトコンテキストを提供する。
  • マージ前に、CIで知識バンドルを自動検証する。
  • 既存のバンドルがないリポジトリのプロジェクトドキュメントを再構成する。

クイックスタート

  1. 1

    Claude Code にマーケットプレイスを追加する

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

    okf プラグインをインストールする

    /plugin install okf@scaccogatto
  3. 3

    Claude に bundle の作成を依頼して、OKF でプロジェクトをドキュメント化する

    /okf:okf produce .okf
  4. 4

    コミットする前に bundle を検証する

    /okf:validate .okf --strict

使う前に知っておきたいこと

  • ツールチェーン全体は Claude Code 向けに構築されており、他のエージェントでは skills のみ利用でき、backfill subagents は利用できません。
  • スクリプトの実行には uv、または pyyaml をインストールした python3 が必要です。
  • プロジェクトはまだ 1.0 以前のため、@v1 のアクションタグはリリースごとに変更される可能性があります。

収録されている特集

Claude Code のツール・スキル・プラグインオープンソースの AI エージェント・フレームワークとアプリMCP サーバーAI エージェントのスキル集静的サイトジェネレーターとドキュメントツール

トピック

#claude-code#knowledge-management#markdown#yaml#agent-skills#llm-tools#mcp#knowledge-graph#ai-agents#claude-code-plugin

よくある質問

okf-skills とは？
OKF（Open Knowledge Format）の知識バンドルを作成・検証・可視化・保守するためのClaude Codeツールキット。 OKFは、YAML frontmatter付きのMarkdownファイルをディレクトリにまとめ、システムに関する知識を保存するオープンかつベンダー中立のフォーマットです。このプロジェクトを使うと、Claude Codeの日常的なワークフローの中で、OKFバンドルを作成、保守、利用、検証、可視化できます。仕様への準拠を判定する決定論的なチェッカー、バンドルをインタラクティブなグラフとして表示するvizスクリプト、gitの履歴とセッションのトランスクリプトからバンドルを再構成するbackfillスキルが含まれています。
okf-skills は無料で使えますか？ライセンスは？
okf-skills は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
okf-skills は今もメンテナンスされていますか？
活発にメンテナンス中。okf-skills の最終コミットは 2026年11月4日 です。
okf-skills は何に使えますか？
サービスのアーキテクチャや意思決定を、コードとともにバージョン管理されたMarkdownで記録する。 コーディングエージェントに、読み取って引用できる構造化されたプロジェクトコンテキストを提供する。 マージ前に、CIで知識バンドルを自動検証する。 既存のバンドルがないリポジトリのプロジェクトドキュメントを再構成する。
okf-skills のインストール方法は？
Claude Code にマーケットプレイスを追加する: /plugin marketplace add scaccogatto/okf-skills okf プラグインをインストールする: /plugin install okf@scaccogatto Claude に bundle の作成を依頼して、OKF でプロジェクトをドキュメント化する: /okf:okf produce .okf コミットする前に bundle を検証する: /okf:validate .okf --strict
okf-skills はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/scaccogatto/okf-skills

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト