Skip to content
Skills Library
AI & agents · Analysis

okf-token-forge

/okf-token-forge

Save tokens by querying a self-updating OKF v0.2 codebase graph before reading source. Use when exploring a repository, locating a module, or avoiding a full-repo dump in DeepSeek Harness, Antigravity, Gemini, or Claude.

Licence
MIT
Last repository change
07.11.2026

Assessment and security

95/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content30 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 07.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Save tokens by querying a self-updating OKF v0.2 codebase graph before reading source. Use when exploring a repository, locating a module, or avoiding a full-repo dump in DeepSeek Harness, Antigravity, Gemini, or Claude.

Original author description

Save tokens by querying a self-updating OKF v0.2 codebase graph before reading source. Use when exploring a repository, locating a module, or avoiding a full-repo dump in DeepSeek Harness, Antigravity, Gemini, or Claude.

How it works

  1. Before reading lots of files
  2. Refresh
  3. Trust
Original SKILL.md headings · 31 lines, 166 words
SKILL.md preview
---
name: okf-token-forge
description: Save tokens by querying a self-updating OKF v0.2 codebase graph before reading source. Use when exploring a repository, locating a module, or avoiding a full-repo dump in DeepSeek Harness, Antigravity, Gemini, or Claude.
---

# OKF token cache

A repository may contain `.okf/`, an Open Knowledge Format v0.2 bundle compiled from the tree with no model calls. It stores file structure, symbols, and local import links. It does not store source text.

## Before reading lots of files

From the `okf-token-forge` package:

```bash
node bin/okf-token-forge.mjs query --root "$PWD" --budget 3500 -- <topic words>
```

Read that stdout. Open a source file only when the slice is not enough. Do not read every file under `.okf/`.

If the CLI is not installed, read `.okf/index.md` first, then one linked concept. Stop. Do not cat the bundle.

## Refresh

`query` recompiles files whose content hash changed and drops concepts for deleted files. There is no git hook. Do not call a model to regenerate the bundle.

```bash
node bin/okf-token-forge.mjs compile --root "$PWD"
node bin/okf-token-forge.mjs status --root "$PWD"
node bin/okf-token-forge.mjs lint --root "$PWD"
```

## Trust

Concepts are `generated` by `process:okf-token-forge/0.1.0` and are not `verified`. Treat them as a map, not as a review.

Versions

The database has no other skills named okf-token-forge.

Database snapshot: 13.11.2026 · package version 80325c01e6d2 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100okf-wiki
    Builds an Open Knowledge Format (OKF) knowledge base from existing docs, notes, or a repo. Use to scaffold an OKF wiki.
  • 100okf-harness
    Unified OKF Harness entrypoint. Use when the user asks to create, find, select, repair, check, ingest into, reconcile, answer from, or graph an OKF Harness workspace. Do not use for generic Markdown editing, repository maintenance, repository dependency graphs, or non-OKF knowledge-base work.
  • 100refresh-okf-mcp-token
    Fetch or refresh an OAuth2 access token for the OKF Data wiki consumption MCP server. Use when the OKF MCP server returns 401/403/unauthorized/expired-token errors, when the user asks to refresh, renew, or get a new OKF MCP token, or when setting up authentication to call the…
  • 100okf-harness
    Unified OKF Harness entrypoint for Pi, OpenCode, and OpenClaw. Use when the user asks to create, find, select, repair, check, ingest into, reconcile, answer from, or graph an OKF Harness workspace. Do not use for generic Markdown editing, repository maintenance, repository…
  • 100okf-init
    Creates the standard knowledge/ structure (OKF v0.2 bundle, knowledge/3.0 profile with the layers fragments/, base/ and projections/) in the current repository. Use when the user says "initialize OKF", "create the knowledge folder", "okf init", "scaffold knowledge", "prepare…
  • 100okf-maintain-knowledge
    OKF — Author, maintain, and consume Open Knowledge Format (OKF) knowledge bundles. Use when capturing project knowledge (services, APIs, schemas, decisions) into an OKF bundle, when updating one after code or docs change, or when a repository's OKF bundle should inform the task.…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.