How long does the integration take?

Change one base URL in an OpenAI-compatible client, or install the Python or TypeScript SDK; the quickstart routes a first request in a few minutes.

Will this lock us into another vendor?

No. The router is Apache-2.0 open source, your provider keys stay yours, and the API is OpenAI-compatible, so leaving is a change of base URL.

What happens when a provider fails?

The router falls back to the next model your policy allows and records the fallback in the trace, so an outage costs a retry, not an incident.

the-clockwork-dark - Skill

Name: the-clockwork-dark
Author: nihilistau

Imported from nihilistau/the-clockwork-dark (AGENTS.md). Install upstream with npx skills add nihilistau/the-clockwork-dark. Copyright stays with the author.

AGENTS.md — Working in The Clockwork Dark

Any agent (Claude, Codex, local models, future tooling) works the same way here: the project's knowledge lives in OKFS, and so do these instructions. (Why: [[okfs-conventions]].)

OKFS in 30 seconds

One concept = one Markdown file with YAML frontmatter (type, title, description required) + body + [[slug]] links. Git-native, agent-traversable, zero runtime lock-in. Spec + tooling: [[okfs-spec]]. Root: knowledge/index.md.

This repo is more than one game: a reusable engine ([[clockwork-engine]]) you can retarget to a new story ([[building-on-the-engine]]). The catalogue of systems is [[systems-catalog]]; to add one, [[extending-the-engine]].

Your loop

Orient — read knowledge/index.md, follow the links your task needs (progressive disclosure: read three small files, not three thousand lines).
Act — the engine owns mechanics; you propose, it resolves. Config-first (get_config()), reuse before rewrite, keep pytest green.
Record — capture durable findings as new concepts (knowledge/<area>/<slug>.md); run OKFSBundle.validate() (no missing frontmatter, no broken links), refresh the index (python scripts/build_okfs_index.py), and log notable changes in [[changelog]].

Programmatic access

Python: from engine.okfs import get_bundle; get_bundle().search("...").
In-game agents: the query_knowledge and read_concept @skill tools.

Provider-agnostic

We speak to the LLM over the OpenAI-compatible REST API ([[lmstudio-integration-overview]]); LM Studio is today's backend, not a dependency ([[llm-migration-plan]]). Same for images/voice ([[install-comfyui]], [[install-voxtral]], [[run-on-the-beast]]).

Claude Code specifics: CLAUDE.md. A drop-in onboarding prompt: prompt.md.

Install the-clockwork-dark and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "nihilistau-the-clockwork-dark-the-clockwork-dark", "kind": "skill", "name": "the-clockwork-dark", "description": "Vendor-neutral guide for any AI agent — read/extend the OKFS knowledge system, honor the engine.", "publisher": "nihilistau", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "agent-guide", "agents", "okfs", "onboarding", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Vendor-neutral guide for any AI agent — read/extend the OKFS knowledge system, honor the engine." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/nihilistau/the-clockwork-dark", "path": "AGENTS.md", "ref": "bb34c70cd45e4ba07ebdad2c65fe48fc23a439a7", "url": "https://github.com/nihilistau/the-clockwork-dark/blob/bb34c70cd45e4ba07ebdad2c65fe48fc23a439a7/AGENTS.md", "key": "nihilistau/the-clockwork-dark/AGENTS.md" } }, "instructions": "# AGENTS.md — Working in The Clockwork Dark\n\nAny agent (Claude, Codex, local models, future tooling) works the same way here:\n**the project's knowledge lives in OKFS**, and so do these instructions. (Why:\n[[okfs-conventions]].)\n\n## OKFS in 30 seconds\nOne concept = one Markdown file with YAML frontmatter (`type`, `title`,\n`description` required) + body + `[[slug]]` links. Git-native, agent-traversable,\nzero runtime lock-in. Spec + tooling: [[okfs-spec]]. Root: `knowledge/index.md`.\n\nThis repo is **more than one game**: a reusable engine ([[clockwork-engine]]) you\ncan retarget to a new story ([[", "cost": { "context_tokens": 455 } }

the-clockwork-dark

About

AGENTS.md — Working in The Clockwork Dark

OKFS in 30 seconds

Your loop

Programmatic access

Provider-agnostic

Install the-clockwork-dark and it becomes one more candidate the router can pick - when it fits.

What it costs to adopt - in engineering time.

One base URL

No vendor lock-in

Failover built in

Use it

Manifest

Reviews