maintain

Audits and repairs knowledge-base health across stale pages, backlinks, citations, and embeddings.

Updated Aug 17, 2026
One-click install
npx skills add https://github.com/AMC-JTC/gbrain-1 --skill maintain-amc-jtc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maintain
Source: https://github.com/AMC-JTC/gbrain-1/tree/main/plugin/skills/maintain
Command: npx skills add https://github.com/AMC-JTC/gbrain-1 --skill maintain-amc-jtc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? A large personal or team knowledge base silently degrades over time: pages go stale, links break, citations go missing, and embeddings drift out of date. This Skill runs systematic health checks across every quality dimension of a GBrain knowledge base and fixes the issues it finds, so the brain stays accurate and trustworthy. ## Core Features & Use Cases - Multi-dimension health audits: Checks stale pages, orphan pages, dead links, missing cross-references, back-link violations, citation gaps, filing rule violations, tag consistency, embedding staleness, RLS security, schema version, and file storage integrity. - Autonomous remediation: Runs gbrain doctor --remediate with a target score and cost cap to automatically walk a dependency-ordered repair plan, or performs manual per-dimension fixes when judgment is needed. - Dream cycle maintenance: Consolidates conversation transcripts into long-term memory via triage-gated synthesis and pattern detection, with idempotency, privacy filters, and spend cooldowns. - Use Case: Ask for a weekly brain health check and receive a structured report table showing issues found, fixed, and remaining per dimension, plus benchmark results verifying search quality has not regressed. ## Quick Start Ask the assistant to run a full brain health check and fix any stale pages, broken backlinks, and missing citations it finds.

Frequently Asked Questions about maintain

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

FAQPage Schema
How do I check the health of my GBrain knowledge base?

Run gbrain doctor --json or gbrain health to get a dashboard of all dimensions including stale pages, orphans, dead links, RLS status, and schema version. For automatic repair, use gbrain doctor --remediate --yes --target-score 90 with a cost cap.

How do I fix orphan pages and broken backlinks in a knowledge base?

Review orphan pages to decide whether they need inbound links from related pages or deletion. For backlinks, check that every entity mention has a corresponding back-link on the entity page, and add missing ones in the Timeline or See Also section.

What does the gbrain dream command do?

gbrain dream runs the full maintenance cycle: lint, backlinks, sync, synthesize, extract, patterns, embed, and orphans. The synthesize phase triages conversation transcripts with a cheap judge model, then fans out synthesis subagents that write reflections, ideas, and timeline entries.

Can I limit how much the dream synthesis cycle costs?

Yes. dream.synthesize.cooldown_hours (default 12) caps run frequency, dream.triage.max_ms bounds judging time, and gbrain doctor --remediate accepts --max-usd as a hard cost cap that refuses submission when the plan would exceed it.

When should I re-run link and timeline extraction?

Run gbrain extract links and gbrain extract timeline after major imports or bulk content edits. New gbrain put calls auto-create links via the auto-link hook, so extraction is mostly a one-time backfill; verify with gbrain stats and gbrain health coverage percentages.

Why is my brain health score stuck below the remediation target?

Some dimensions have hard ceilings: an empty brain with no entity pages caps graph_coverage at 70, and an unconfigured embedding key caps at 60. The remediate command bails with a list of what is missing rather than looping indefinitely.