GoogleCloudPlatform / GoogleCloudPlatform/knowledge-catalog

okf-gem: The complete OKF harness (skills + CLI + server)

Open
#198 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
9.2k
Forks
782
Avg merge
6h 36m
Merged PRs (30d)
85

Description

Image

I implemented a complete toolkit to facilitate the OKF adoption, which is composed of three cores:

> An `Agent Skill` (the 🧠 ), a `CLI/Lib` (the 💪 ), and a `Server` (the 📊 )

The agent knows how to author, curate, and, more importantly, how to consume (CLI tools + Server (for humans)).

It is ​Open source and runs 100% locally! (using Ruby or [Docker](https://docker.okfgem.com/)).

Here is the GitHub repo: https://github.com/serradura/okf-gem (https://demo.okfgem.com)

Image

The knowledge graph looks like this:​

Image

And you can test it here: https://demo.okfgem.com/

**Step by step to experiment with it:**

1. Install the gem: `gem install okf`
2. Install the skill: `okf skill .claude` (or any other agent)
3. Start an agent session (`claude`)
4. Execute `/okf produce based on `

**Once you have your first bundle, you can do:**

Run the command `/okf maintain` in your agent session to keep it updated. Or, install the [Claude Plugin](https://claude.okfgem.com/), which will run this for you (after triggering the Stop hook).

You can also run `okf server ` to render your live graph locally. Or ask the agent to up it for you.

If you want to know more, please check out these other resources:

* Site: https://okfgem.com/
* Blog: https://okfgem.com/blog
* Docs: https://okfgem.com/docs
* LLMs.txt: https://okfgem.com/llms.txt (https://okfgem.com/llms-full.txt)
* Claude Plugin: https://claude.okfgem.com/

**It is also possible to run it through Docker** (**_no Ruby required_**):

* https://docker.okfgem.com/

Image

Looking forward to feedback and critiques.

Thanks!

Contributor guide

Open the contributing guide

Research direction

The issue describes the external okf-gem toolkit, including its CLI, server, agent skill, Docker usage, and linked documentation, but names no file or test in this repository. Start by reviewing the linked okf-gem repository and determine whether a concrete integration or change is intended here; completion is not defined by the issue.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, ruby
Domain
tooling
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.