Agent skill

Brain Schema Author

by itechmeat in itechmeat/open-second-brain

Adds, renames, reviews and explains Brain schema tokens, aliases, prefixes and link types in Open Second Brain vaults, previewing each change before applying it.

MITAuto-check passedKnowledge Management

Install Brain Schema Author

skills CLI
$ npx skills add itechmeat/open-second-brain --skill schema-author -a claude-code

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

GitHub CLI
$ gh skill install itechmeat/open-second-brain schema-author --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/itechmeat/open-second-brain.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/schema-author .claude/skills/schema-author && 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
schema-author
GitHub stars
430
Token cost
~513 tokens
SKILL.md length
254 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

Adds, renames, reviews and explains Brain schema tokens, aliases, prefixes and link types in Open Second Brain vaults, previewing each change before applying it.

  • Works in 6 steps: Inspect the active schema pack with… → Check current usage and findings with… → Explain candidate tokens with… → …
  • Adding or renaming a schema token in an Open Second Brain vault
  • SKILL.md covers Workflow and Mutation Notes
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Use it when a task changes the active schema pack in `Brain/_brain.yaml` or checks content against it. The workflow inspects the active pack with `schema_inspect` or `o2b brain schema --json`, looks at usage through the stats, lint and orphans views, and explains candidate tokens before renaming or deleting any. Changes are previewed with a dry run that returns the resulting pack and diff and writes nothing, then applied only through `schema_apply_mutations` so writes are locked, atomic and audited.

A clean preview means the mutations are valid, not that the apply will succeed, because two write-time checks only run on apply. Afterwards the agent reruns lint and stats and reports changed tokens and remaining findings. Supported operations are adding, removing and updating types, aliases, prefixes and link types, plus setting extractability and expert routing. Tokens must be lowercase normalized tokens, preferably small and durable.

When your agent uses it

  • Adding or renaming a schema token in an Open Second Brain vault
  • Reviewing aliases, prefixes or link types against the active schema pack
  • Explaining what a schema token does before deleting it

Example prompts

  • “Add a meeting-note type to the Brain schema and show me the dry-run diff first.”
  • “Explain the project alias before we rename it.”
  • “Run lint on the Brain schema and list orphaned tokens.”

Requirements

  • An Open Second Brain vault with a Brain/_brain.yaml schema pack

Workflow steps

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

  1. Inspect the active schema pack with schema_inspect (view="active_pack") or o2b brain schema --json.
  2. Check current usage and findings with schema_inspect views stats, lint, and orphans.
  3. Explain candidate tokens with schema_inspect (view="explain_type") before renaming or deleting them.
  4. Preview the batch first with schema_apply_mutations (dry_run=true) or o2b brain schema apply --dry-run --mutation ...: it returns the pack…
  5. Apply schema changes only through schema_apply_mutations or o2b brain schema apply --mutation ... so writes are locked, atomic, and audited.
  6. Re-run lint/stats after mutation and report changed tokens plus any remaining findings.

What it can do on your machine

Read from SKILL.md and the folder at commit 0f0c9a7. 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.

    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

Brain Schema Author loads about 513 tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 254 words of instructions outside code blocks.

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

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 itechmeat/open-second-brain at commit 0f0c9a7, republished under its MIT licence (© itechmeat). 254 words, ~513 tokens.

Download SKILL.mdSave it as .claude/skills/schema-author/SKILL.md (or your agent's skills folder).
name
schema-author
description
Use when adding, renaming, reviewing, or explaining Brain schema tokens, aliases, prefixes, link types, extractability, or expert routing in Open Second Brain vaults.

Schema Author

Use this skill when a task changes the active Brain schema pack in Brain/_brain.yaml or reviews content against that schema.

Workflow

  1. Inspect the active schema pack with schema_inspect (view="active_pack") or o2b brain schema --json.
  2. Check current usage and findings with schema_inspect views stats, lint, and orphans.
  3. Explain candidate tokens with schema_inspect (view="explain_type") before renaming or deleting them.
  4. Preview the batch first with schema_apply_mutations (dry_run=true) or o2b brain schema apply --dry-run --mutation ...: it returns the pack that would result and its diff and writes nothing at all - no config write, no audit record, no lock file. It runs the same pack validator the apply runs, so a batch that validator rejects raises identically in both. It does not run the two checks that exist only because the apply writes: the vault-identity write guard, and the atomic writer's re-parse of the rendered YAML. A batch that renders to unparseable YAML previews clean and fails on apply, so treat a clean preview as "the mutations are valid", not as "the apply will succeed".
  5. Apply schema changes only through schema_apply_mutations or o2b brain schema apply --mutation ... so writes are locked, atomic, and audited.
  6. Re-run lint/stats after mutation and report changed tokens plus any remaining findings.

Mutation Notes

Supported operations are add_type, remove_type, update_type, add_alias, remove_alias, add_prefix, remove_prefix, add_link_type, remove_link_type, set_extractable, and set_expert_routing.

Schema tokens must be lowercase normalized tokens accepted by Open Second Brain schema validation. Prefer small, durable tokens over project-specific phrasing unless the schema pack is explicitly project-scoped.

© itechmeat, 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/schema-author of itechmeat/open-second-brain.

Open the folder on GitHubat commit 0f0c9a7

Compare with similar skills

Brain Schema Author 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.

Brain Schema Author compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Brain Schema Author this skillitechmeat/open-second-brain430—~513Automated safety check: PassMIT
Obsidian Wiki Vault SetupAgriciDaniel/claude-obsidian15k—~1.3kAutomated safety check: PassMIT
Icm ArchitectRinDig/icm-architect1.8k—~3.2kAutomated safety check: PassMIT
NanoClaw LLM Wiki Setupnanocoai/nanoclaw31k1 repos~1.3kAutomated safety check: PassMIT
Obsidian Project Knowledge BaseGalaxy-Dawn/claude-scholar5.7k—~551Automated safety check: PassMIT
Second Brain QueryNicholasSpisak/second-brain735—~712Automated safety check: NotesNone

Similar skills

  • Obsidian Wiki Vault Setup

    AgriciDaniel/claude-obsidian

    Sets up or adopts a separate Obsidian knowledge vault through the claude-obsidian core script and routes follow-up work to the right wiki sub-skill.

    15k GitHub stars~1.3k tokensUpdated 27 days ago
    Knowledge ManagementAuto-check passed
  • Icm Architect

    RinDig/icm-architect

    Design any process, idea, problem, or body of knowledge into an ICM (Interpretable Context Methodology) workspace — folder structure as agent architecture — or restructure an existing folder, repo…

    1.8k GitHub stars~3.2k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check passed
  • NanoClaw LLM Wiki Setup

    nanocoai/nanoclaw

    Adds a persistent wiki knowledge base to a NanoClaw group following Karpathy's LLM Wiki pattern, with folders, a tailored container skill and a CLAUDE.md section.

    31k GitHub starsUsed in 1 repo~1.3k tokens
    Knowledge ManagementAuto-check passed
  • Obsidian Project Knowledge Base

    Galaxy-Dawn/claude-scholar

    Maintains a project-scoped Obsidian research knowledge base: bootstrapping its folders, routing notes, updating hub, plan and index notes, and linting.

    5.7k GitHub stars~551 tokensUpdated 14 days ago
    Knowledge ManagementAuto-check passed
  • Second Brain Query

    NicholasSpisak/second-brain

    Answer questions against the knowledge base wiki. An agent skill from NicholasSpisak/second-brain.

    735 GitHub stars~712 tokensUpdated 6 mo ago
    Knowledge ManagementAuto-check: notes
  • Searches and writes a company-wide knowledge brain through the gbrain CLI, so durable decisions and facts about people, projects and history stay findable beyond one session.

    31k GitHub stars~875 tokensUpdated today
    Knowledge ManagementAuto-check passed

More from itechmeat/open-second-brain

  • Decision Model Setup

    itechmeat/open-second-brain

    Sets up, evaluates or turns off Open Second Brain's optional decision-model feature, starting from the o2b decision-model check command and a provider route you choose.

    430 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Codegraph Detection Partner

    itechmeat/open-second-brain

    Teaches the agent to detect whether the codegraph symbol graph is available and use it for callers, callees and impact questions, without installing or writing anything for it.

    430 GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Open Second Brain Embeddings Setup

    itechmeat/open-second-brain

    Walks through turning on semantic search in Open Second Brain: embedding key, sqlite-vec extension, first reindex and an optional periodic refresh, starting from o2b search check.

    430 GitHub stars~2.6k tokensUpdated today
    Auto-check: warnings
  • Open Second Brain

    itechmeat/open-second-brain

    Lets an agent read, write and maintain its own memory in a Brain folder of an Obsidian-compatible vault, while keeping the user's own notes read-only.

    430 GitHub stars~1.2k tokensUpdated today
    Auto-check passed

Questions about Brain Schema Author

What does Brain Schema Author do?

Adds, renames, reviews and explains Brain schema tokens, aliases, prefixes and link types in Open Second Brain vaults, previewing each change before applying it. yaml` or checks content against it. The workflow inspects the active pack with `schema_inspect` or `o2b brain schema --json`, looks at usage through the stats, lint and orphans views, and explains candidate tokens before renaming or deleting any.

When should I use Brain Schema Author?

Brain Schema Author fits situations like: adding or renaming a schema token in an Open Second Brain vault; reviewing aliases, prefixes or link types against the active schema pack; explaining what a schema token does before deleting it.

How do I install Brain Schema Author in Claude Code?

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

How do I install Brain Schema Author in Codex?

Run `npx skills add itechmeat/open-second-brain --skill schema-author -a codex`. Or copy the skill folder (skills/schema-author in itechmeat/open-second-brain) into .agents/skills/schema-author in your project. Codex loads it when a task matches its description.

Can I use Brain Schema Author 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 itechmeat/open-second-brain --skill schema-author -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/schema-author, .gemini/skills/schema-author, .github/skills/schema-author and .opencode/skills/schema-author in your project.

What does Brain Schema Author need to run?

SKILL.md names no scripts, command-line tools or credentials: Brain Schema Author is instructions for the agent only. Our summary lists: An Open Second Brain vault with a Brain/_brain.yaml schema pack.

Does Brain Schema Author 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 Brain Schema Author 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 Brain Schema Author use?

Brain Schema Author 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 Brain Schema Author use?

About 513 tokens (SKILL.md is roughly 2.1k 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 Brain Schema Author?

Skills that share tags, products or a category with Brain Schema Author: Obsidian Wiki Vault Setup (AgriciDaniel/claude-obsidian, 15k stars), Icm Architect (RinDig/icm-architect, 1.8k stars), NanoClaw LLM Wiki Setup (nanocoai/nanoclaw, 31k stars) and Obsidian Project Knowledge Base (Galaxy-Dawn/claude-scholar, 5.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Brain Schema Author?

itechmeat (a GitHub user) maintains it in itechmeat/open-second-brain, which has 430 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 6, 2026.

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