# Maintain

> GBrain-inspired maintenance for Codex. Use when the user wants a health check, consistency audit, stale-doc sweep, or package cleanup pass.

- Skill: `mphaxise/maintain` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mphaxise/maintain`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mphaxise/maintain/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: mphaxise (https://skillmd.com/u/mphaxise)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mphaxise/maintain

---


# Maintain

Use this skill when the user wants a maintenance pass over the repo, docs, trackers, or saved reports.

This port is adapted from `garrytan/gbrain` at commit `0b47afbf402a4e27a648bb9d131ce584461461ea`.

## Important Adaptation

Upstream GBrain runs health checks against a brain database, backlinks, and citation-bearing pages. In this repo, the closest equivalents are:

- registry and docs consistency
- missing or stale skill artifacts
- report/task file drift
- structural validation and targeted audits

## Workflow

1. Run the package checks first:
   - `python3 scripts/validate_repo.py`
   - `python3 -m unittest discover -s tests`
2. Inspect the relevant layer:
   - registries and docs
   - task or report files
   - skills and supporting references
3. Identify concrete issues:
   - stale docs
   - missing files
   - inconsistent paths or naming
   - uncategorized or duplicated reports
4. Fix what is safe and explicit.
5. Save or summarize a maintenance report when helpful.

## Current Upstream Coverage

Audit stale pages, orphans, dead links, missing backlinks, filing violations, citation debt, tag consistency, graph density, embedding freshness when applicable, schema health, storage health, and unresolved threads. Support a manual pass and an autonomous target-score loop, but never bulk-fix private brain content without a scoped plan and validation rerun.

## Guardrails

- Do not delete content without clear justification.
- Prefer specific fixes over vague "health check passed" language.
- Read before rewriting when a file is non-trivial.