xsavikx/okf-skills

okf-fs

Local filesystem connector that produces and ingests Open Knowledge Format (OKF) bundles documenting directory trees and file metadata, honoring .okfignore and .okf-metadata.yaml.

ソースを見る

使い方

  1. インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
  2. 必要なツール、認証情報、対応環境を原文で確認します。
  3. 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/xsavikx/okf-skills --skill okf-fs

開始前の確認

  • 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
  • スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
リポジトリの原文

見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。

Skill: okf-fs (Local Filesystem OKF Connector)

This skill produces and ingests OKF bundles documenting local directory tree structures and metadata, respecting .okfignore files.

Setup

The connector is written in Go and requires Go 1.24+ to build from source:

bash
# Install the published binary (Go 1.24+) — no clone needed:
go install github.com/xSAVIKx/okf-skills/skills/okf-fs@v0.1.0

# …or build from a clone of the repository:
cd skills/okf-fs
go build -o okf-fs .

Commands

1. produce

Traverses the specified directory, ignores files matching .okfignore rules, reads description text from .okf-metadata.yaml, and outputs an OKF bundle.

bash
./okf-fs produce --dir <directory-to-document> --out <bundle-output-dir>

Options:

  • --dir (string): The path to the local directory to document (required).
  • --out (string): The path where the generated OKF bundle will be created (required).

2. ingest

Compares an OKF bundle with the target directory, checks for file existence and mismatches, and optionally syncs file descriptions back into .okf-metadata.yaml.

bash
./okf-fs ingest --dir <target-directory> --bundle <okf-bundle-dir> [--sync]

Options:

  • --dir (string): The target directory to compare against (required).
  • --bundle (string): The path to the OKF bundle to ingest (required).
  • --sync (bool): If true, updates .okf-metadata.yaml at the directory root with the descriptions from the bundle.

3. Inspect the Schema (self-description)

Print a machine-readable JSON description of this skill's commands and flags (used by okf-mcp to expose the skill as an MCP tool):

bash
./okf-fs schema

タスクに関連する項目

同じリポジトリから

関連する Skills

すべての Skills
xsavikx
コミュニティ

okf-csv

CSV connector that produces and ingests Open Knowledge Format (OKF) bundles from a directory of CSV files. Infers each file's column schema (integer/number/boolean/date/string) by sampling rows, optionally embeds a per-column data profile and sample rows, and syncs descriptions back to a .okf-metadata.yaml sidecar. Use when documenting or cataloging a folder of CSV/flat files, or capturing their inferred schema and stats as an OKF bundle. CGO-free, pure Go.

導入数
1
GitHub Stars
34
更新日
8月30日
xsavikx
コミュニティ

okf-enrich

Guidance for an AI agent to enrich an Open Knowledge Format (OKF) bundle with high-quality concept descriptions using its own LLM — grounded in the bundle's schema, data profile, and samples — then optionally sync them back to the source. Use when an OKF bundle has missing, weak, or low-quality descriptions that should be improved before publishing or ingestion. Instructions-only; no binary required.

導入数
1
GitHub Stars
34
更新日
8月30日
xsavikx
コミュニティ

okf-graphql

GraphQL connector that produces and ingests Open Knowledge Format (OKF) bundles from a GraphQL SDL document. Parses the schema into one concept per user-defined type (object/input/interface/enum/union) and per root operation (query/mutation/subscription field), links fields and operations to the types they reference as native relationship edges, and syncs descriptions back to a .okf-metadata.yaml sidecar. Use when documenting or cataloging a GraphQL API from its schema, with no live server. Pure

導入数
1
GitHub Stars
34
更新日
8月30日
xsavikx
コミュニティ

okf-mysql

MySQL connector that produces and ingests Open Knowledge Format (OKF) bundles from database schemas and table/column comments. Use when documenting or cataloging a MySQL database, extracting its schema and comments into OKF, or syncing descriptions back to MySQL via DDL.

導入数
1
GitHub Stars
34
更新日
8月30日