菜单
Git repository connector that produces and ingests Open Knowledge Format (OKF) bundles documenting repository file trees plus commit-history metadata (times, authors, messages), honoring .gitignore and .okfignore. Use when documenting or cataloging a Git repository as an OKF bundle.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Generic Model Context Protocol (MCP) server that discovers installed okf-* skill binaries and exposes their produce/ingest commands as MCP tools for any MCP-capable harness (Claude Code, Gemini CLI, etc.). Use when wiring OKF Skills into an agent over MCP instead of invoking each connector binary directly.
Google Cloud BigQuery connector that produces and ingests Open Knowledge Format (OKF) bundles from dataset schemas, table/field descriptions, and metadata. Use when documenting or cataloging BigQuery datasets, extracting schema metadata into OKF, or syncing descriptions back to BigQuery tables and fields.
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.
Local filesystem connector that produces and ingests Open Knowledge Format (OKF) bundles documenting directory trees and file metadata, honoring .okfignore and .okf-metadata.yaml. Use when documenting or cataloging a local folder structure, or capturing filesystem metadata as an OKF bundle.
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 Go.
Deterministic validator for Open Knowledge Format (OKF) bundles. Checks spec conformance (root index.md carries only okf_version, subdirectory index.md files carry no frontmatter, every concept has a non-empty type) plus enrichment coverage (placeholder descriptions, broken cross-links, orphans), and gates CI via its exit code. Use to validate an OKF bundle before publishing or ingestion, or to fail a build when a bundle regresses. Complements skills-ref validate, which only checks SKILL.md frontmatter.
| name | okf-git |
| description | Git repository connector that produces and ingests Open Knowledge Format (OKF) bundles documenting repository file trees plus commit-history metadata (times, authors, messages), honoring .gitignore and .okfignore. Use when documenting or cataloging a Git repository as an OKF bundle. |
| license | Apache-2.0 |
| compatibility | Requires the Go toolchain (1.24+) to build the connector binary, plus a local Git repository to read history from. |
| metadata | {"version":"0.8.0","author":"Yurii Serhiichuk","tags":"okf, knowledge-catalog, git, documentation"} |
This skill produces and ingests OKF bundles documenting Git repository file trees, including revision history metadata (commit times, authors, messages), respecting .gitignore and .okfignore files.
The connector is written in Go and requires Go 1.24+ to build from source:
# Install the published binary (Go 1.24+) — no clone needed:
go install github.com/xSAVIKx/okf-skills/skills/okf-git@v0.1.0
# …or build from a clone of the repository:
cd skills/okf-git
go build -o okf-git .
produceTraverses the Git repository files, skips ignored files, queries commit logs for history metadata, reads description comments from .okf-metadata.yaml, and outputs an OKF bundle.
./okf-git produce --repo <repository-path> --out <bundle-output-dir>
Options:
--repo (string): The path to the local Git repository to document (required).--out (string): The path where the generated OKF bundle will be created (required).ingestValidates an OKF bundle against tracked Git repository files and optionally syncs descriptions back into .okf-metadata.yaml at the repository root.
./okf-git ingest --repo <repository-path> --bundle <okf-bundle-dir> [--sync]
Options:
--repo (string): The path to the local Git repository to update (required).--bundle (string): The path to the OKF bundle to ingest (required).--sync (bool): If true, updates .okf-metadata.yaml at the repository root with the descriptions from the bundle.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):
./okf-git schema