Agent skill

Ingest

by guhcostan in guhcostan/claude-mega-brain

Create or update a single OKF concept file from raw input. An agent skill from guhcostan/claude-mega-brain.

MITAuto-check passedKnowledge Management

Install Ingest

skills CLI
$ npx skills add guhcostan/claude-mega-brain --skill ingest -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install guhcostan/claude-mega-brain ingest --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/guhcostan/claude-mega-brain.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/ingest .claude/skills/ingest && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ingest
GitHub stars
126
Token cost
~694 tokens
SKILL.md length
278 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
MIT

At a glance

Create or update a single OKF concept file from raw input. An agent skill from guhcostan/claude-mega-brain.

  • Works in 9 steps: Read the source material → Identify the concept type and canonical… → Write description: one sentence, plain… → …
  • The user wants to document a specific table
  • SKILL.md covers Before writing, Output format, Common types and Process, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Ingest is an agent skill from guhcostan/claude-mega-brain. Create or update a single OKF concept file from raw input. Use when the user wants to document a specific table, metric, API, service, or concept in the knowledge base — even if they say "add this to the okf", "documenta essa tabela", "cria um conceito pra isso", "adiciona no knowledge base", "register this API", or pastes a schema/description and says to save it. If no OKF files exist yet, suggest /mega-brain:init first.

Its SKILL.md is about 690 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Knowledge Management, covering Knowledge bases. The repository describes itself as: OKF-powered knowledge context for Claude Code — injects your project's knowledge base at every session. The licence is MIT.

When your agent uses it

  • The user wants to document a specific table
  • Concept in the knowledge base — even if they say add this to the okf
  • Documenta essa tabela
  • Cria um conceito pra isso

Example prompts

  • “add this to the okf”
  • “documenta essa tabela”
  • “cria um conceito pra isso”
  • “/ingest”

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. Read the source material
  2. Identify the concept type and canonical name
  3. Write description: one sentence, plain language
  4. Add resource URL if there's a live resource (BQ console URL, API endpoint, dashboard)
  5. Write the body with exact values — preserve field names, types, and formulas as-is; do not generalize
  6. Link to related concepts with Name — this builds the knowledge graph
  7. Save next to related OKF files (e.g. docs/tables/.md or /tables/.md)
  8. Add one line to index.md: - Title — description
  9. Append to log.md: — added

What it can do on your machine

Read from SKILL.md and the folder at commit de1ab9c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ingest loads about 694 tokens when it runs. Until then it costs about 108 tokens; SKILL.md has 278 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~108
When it runs · the whole SKILL.md, loaded when a task matches
~694

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from guhcostan/claude-mega-brain at commit de1ab9c, republished under its MIT licence (© guhcostan). 278 words, ~694 tokens.

Download SKILL.mdSave it as .claude/skills/ingest/SKILL.md (or your agent's skills folder).
name
ingest
description
Create or update a single OKF concept file from raw input. Use when the user wants to document a specific table, metric, API, service, or concept in the knowledge base — even if they say "add this to the okf", "documenta essa tabela", "cria um conceito pra isso", "adiciona no knowledge base", "register this API", or pastes a schema/description and says to save it. If no OKF files exist yet, suggest /mega-brain:init first.

ingest — OKF Concept Writer

Turns raw input (schema dump, API doc, user description, table definition) into one OKF-formatted .md file committed to the knowledge base.

Before writing

Look for existing OKF files: any .md with type: frontmatter, or index.md / log.md in the project. If none exist, stop and tell the user to run /mega-brain:init first.

If .mega-brain.json defines dir, save new concepts under that directory. Otherwise, choose a sensible location (docs/, project root, etc.) consistent with existing OKF files.

Check if a concept with the same name already exists. If so, ask whether to update it or create a new one.

Output format

One .md file per concept. Only type is required:

markdown
---
type: <concept type>
title: <display name>
description: <one sentence, plain language, no jargon>
resource: <URL to the actual resource, if any>
tags: [<tag1>, <tag2>]
timestamp: <ISO 8601 date>
---

<body: exact schema, formula, join patterns, examples, caveats>

Common types

TypeUse for
BigQuery TableBQ tables with schema
BigQuery DatasetBQ datasets
TableNon-BQ database tables
MetricKPI or business metric with formula
APIREST/GraphQL endpoints
RunbookOperational procedures
ConceptBusiness or domain terminology
ServiceInternal microservices
PipelineETL or data pipelines

Types are freeform — add your own.

Process

  1. Read the source material
  2. Identify the concept type and canonical name
  3. Write description: one sentence, plain language
  4. Add resource URL if there's a live resource (BQ console URL, API endpoint, dashboard)
  5. Write the body with exact values — preserve field names, types, and formulas as-is; do not generalize
  6. Link to related concepts with [Name](relative-path.md) — this builds the knowledge graph
  7. Save next to related OKF files (e.g. docs/tables/<slug>.md or <config-dir>/tables/<slug>.md)
  8. Add one line to index.md: - [Title](path) — description
  9. Append to log.md: <date> — added <title>

Updating an existing entry

  • Update timestamp
  • Preserve existing wikilinks unless explicitly removing them
  • Keep description to one sentence — push additional detail into the body

© guhcostan, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/ingest of guhcostan/claude-mega-brain.

Open the folder on GitHubat commit de1ab9c

Compare with similar skills

Ingest next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ingest compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ingest this skillguhcostan/claude-mega-brain126—~694Automated safety check: PassMIT
Knowledge Searchdataelement/bisheng12k—~1.1kAutomated safety check: PassApache-2.0
Capture Conversationoutline/outline41k—~474Automated safety check: PassCustom licence
Find And Citeoutline/outline41k—~537Automated safety check: PassCustom licence
Xhs Virtual Productchenjin-cmd/xhs-virtual-product729—~862Automated safety check: PassMIT
OpenkbVectifyAI/OpenKB4.8k1 repos~2kAutomated safety check: WarnApache-2.0

Similar skills

  • Knowledge Search

    dataelement/bisheng

    Search the user's knowledge bases and knowledge spaces (企业知识库检索).

    12k GitHub stars~1.1k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Capture Conversation

    outline/outline

    Save the current conversation, a decision, or a set of notes as a document in an Outline collection; use when the user wants to keep what was discussed in their knowledge base.

    41k GitHub stars~474 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Find And Cite

    outline/outline

    Answer questions from the Outline knowledge base with quotes and links to the source documents; use when the user asks what the team knows, documented, or decided about a topic.

    41k GitHub stars~537 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Xhs Virtual Product

    chenjin-cmd/xhs-virtual-product

    This skill helps plan, select, produce, and market Xiaohongshu (RED) virtual/digital products — templates, knowledge bases, test tools, study materials.

    729 GitHub stars~862 tokensUpdated 9 days ago
    Knowledge ManagementAuto-check passed
  • Openkb

    VectifyAI/OpenKB

    A skill your agent uses when the user asks about content in their OpenKB knowledge base — research topics, concepts compiled from their documents, cross-document synthesis — or mentions openkb, an…

    4.8k GitHub starsUsed in 1 repo~2k tokens
    Knowledge ManagementAuto-check: warnings
  • Learn From Materials

    dmoshehun-prog/learn-from-materials

    Turns books, PDFs, slides and web pages into a source-grounded knowledge base and an interactive learning page in English or Chinese, with quizzes, relationship maps and reusable methodology notes.

    947 GitHub stars~7.9k tokensUpdated 3 days ago
    Knowledge ManagementAuto-check passed

More from guhcostan/claude-mega-brain

  • Claude Mega Brain

    guhcostan/claude-mega-brain

    OKF knowledge navigation. An agent skill from guhcostan/claude-mega-brain.

    126 GitHub stars~588 tokensUpdated 2 mo ago
    Auto-check passed
  • Init

    guhcostan/claude-mega-brain

    Initialize OKF knowledge base files in the current project. An agent skill from guhcostan/claude-mega-brain.

    126 GitHub stars~530 tokensUpdated 2 mo ago
    Auto-check passed
  • Migrate

    guhcostan/claude-mega-brain

    Scan the project and migrate existing documentation into OKF format.

    126 GitHub stars~975 tokensUpdated 2 mo ago
    Auto-check passed

Questions about Ingest

What does Ingest do?

Create or update a single OKF concept file from raw input. An agent skill from guhcostan/claude-mega-brain. Ingest is an agent skill from guhcostan/claude-mega-brain. Create or update a single OKF concept file from raw input.

When should I use Ingest?

Ingest fits situations like: the user wants to document a specific table; concept in the knowledge base — even if they say add this to the okf; documenta essa tabela; cria um conceito pra isso.

How do I install Ingest in Claude Code?

Run `npx skills add guhcostan/claude-mega-brain --skill ingest -a claude-code`. Or copy the skill folder (skills/ingest in guhcostan/claude-mega-brain) into .claude/skills/ingest in your project. Claude Code loads it when a task matches its description.

How do I install Ingest in Codex?

Run `npx skills add guhcostan/claude-mega-brain --skill ingest -a codex`. Or copy the skill folder (skills/ingest in guhcostan/claude-mega-brain) into .agents/skills/ingest in your project. Codex loads it when a task matches its description.

Can I use Ingest in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add guhcostan/claude-mega-brain --skill ingest -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ingest, .gemini/skills/ingest, .github/skills/ingest and .opencode/skills/ingest in your project.

What does Ingest need to run?

SKILL.md names no scripts, command-line tools or credentials: Ingest is instructions for the agent only.

Does Ingest access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Ingest safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ingest use?

Ingest is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ingest use?

About 694 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ingest?

Skills that share tags, products or a category with Ingest: Knowledge Search (dataelement/bisheng, 12k stars), Capture Conversation (outline/outline, 41k stars), Find And Cite (outline/outline, 41k stars) and Xhs Virtual Product (chenjin-cmd/xhs-virtual-product, 729 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ingest?

guhcostan (a GitHub user) maintains it in guhcostan/claude-mega-brain, which has 126 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on July 22, 2026.

Source: guhcostan/claude-mega-brain on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.