brain-ops

Create and update gbrain knowledge pages with citations and sync workflows.

Updated Jun 23, 2026
One-click install
npx skills add https://github.com/Walliiee/agent-harness --skill brain-ops-walliiee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brain-ops
Source: https://github.com/Walliiee/agent-harness/tree/main/skills/brain-ops
Command: npx skills add https://github.com/Walliiee/agent-harness --skill brain-ops-walliiee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill handles durable write operations for a structured gbrain knowledge base when you need to create, update, or sync pages without mixing in read-only query behavior.

Core Features & Use Cases

  • Brain Page Writes: Create and update gbrain pages, write-backs, and citations for durable knowledge capture.
  • Source Registration and Sync: Register sources and sync structured knowledge so updates become searchable and consistent.
  • Operational Guardrails: Enforces using the real gbrain home, avoids duplicate writes, and preserves source attribution.
  • Use Case: A user asks to save a decision summary, add citations, and sync it to the active brain source.

Quick Start

Use the brain-ops skill to create or update the relevant gbrain page, then verify the result with the smallest appropriate gbrain get or sync command.

Frequently Asked Questions about brain-ops

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write and sync structured knowledge pages to a knowledge base?

To write and sync structured knowledge pages, perform structured write operations to create or update pages, register sources, and apply citations. Explicitly target the correct home directory to ensure durable knowledge capture and consistency.

What is the best way to avoid duplicate writes when updating a structured memory knowledge base?

Avoid duplicate writes in a structured memory knowledge base by enforcing operational guardrails during page maintenance. The system applies duplicate avoidance checks and preserves source attribution before completing any write or sync workflows.

How do I register sources and add citations for durable knowledge capture?

Register sources and add citations for durable knowledge capture by executing structured write operations. This process applies attribution preservation to sync updates, making the registered source content searchable and consistent within the target brain.

Do I need explicit directory targeting to sync knowledge pages?

Yes, explicit directory targeting is required to sync knowledge pages safely. You must target the real gbrain home directory to ensure write operations apply to the correct environment and pass post-write verification checks.

How do I verify a knowledge base write operation was successful?

Verify a knowledge base write operation by running the smallest appropriate get or sync command after the write. This post-write verification step checks that the structured memory page, sources, and citations were updated correctly.

Why should I separate read-only queries from write operations in a knowledge base?

Separate read-only queries from write operations to maintain operational guardrails and prevent unintended side effects. Isolating write operations ensures durable knowledge capture, source registration, and page maintenance occur without mixing in read-only query behavior.