| name | claude-mega-brain |
| description | OKF knowledge navigation. ALWAYS use this skill the moment a `<mega-brain>` block appears in session context — it means the project has documented concepts and you must consult them before answering questions about data, schemas, metrics, APIs, or systems. Also trigger when the user asks about a table, column, metric definition, service, or API endpoint and there's any chance it's documented in the project. When in doubt, read the file directly. |
claude-mega-brain — OKF Knowledge Navigator
When <mega-brain> context is present, the project has OKF-documented concepts — any Markdown file with type: in its YAML frontmatter. These are the authoritative source for domain knowledge: exact schemas, metric formulas, API contracts, runbooks, business definitions. Answers from the knowledge base beat answers from training data.
What OKF files look like
Any .md file anywhere in the project with YAML frontmatter containing type::
---
type: BigQuery Table
title: Orders
description: One row per completed customer order.
resource: https://...
tags: [sales, revenue]
timestamp: 2026-06-29T00:00:00Z
---
| Column | Type | Description |
...
No dedicated folder required. The file can live in docs/, wiki/, project root, anywhere.
Navigation
- Read the file — paths in
<mega-brain> are relative to the project root; use the Read tool directly
- Follow links —
[text](rel-path.md) links in the body point to related concepts; read them
- log.md — chronological changelog; last 3 entries are injected automatically
- Linked concepts auto-surface — after you read an OKF file, linked concept summaries appear via PostToolUse hook
When to proactively read files
- User asks about a data source, table, column, or metric — check
<mega-brain> index first
- Before writing SQL, queries, or code that touches project data
- When a business term is ambiguous — OKF has the canonical definition
- When the user says "check the knowledge base", "what do we know about X", or "olha no okf"
If <mega-brain> context is missing
No OKF concepts found in the project yet. Suggest:
/mega-brain:init — creates index.md and log.md to get started/mega-brain:migrate — scans existing docs and generates OKF files automatically
