garrytan/gbrain

repo-architecture

Where new brain files go.

Quelltext ansehen

Verwendung

  1. Installationsbefehl kopieren und das Quellpaket vor der Installation in der eigenen Agentenumgebung prüfen.
  2. Benötigte Werkzeuge, Zugangsdaten und Hosts im Original prüfen.
  3. Eingabe und gewünschtes Ergebnis beschreiben und die Ausgabe mit den Quellen abgleichen.
npx skills add https://github.com/garrytan/gbrain --skill repo-architecture

Vor dem Start

  • Die Installation umfasst weder Modellabo noch API-Kontingent oder Dateizugriffsrechte.
  • Sterne und Installationen zeigen Aktivität, keine unabhängige Qualitäts- oder Sicherheitsprüfung.
Originales Skill-Dokument

Aus dem Quell-Repository gerendert; Überschriften, Beispiele, Code, Tabellen, Links und Bilder bleiben erhalten.

Repo Architecture — Filing Rules

Full filing rules: See skills/_brain-filing-rules.md

Contract

This skill guarantees:

  • Every new page is filed by primary subject (not format, not source)
  • The decision protocol is followed for ambiguous cases
  • Common misfiling patterns are caught

Phases

  1. Identify the primary subject. What would you search for to find this page?
  2. Walk the decision tree:
  • About a person → people/{name-slug}.md
  • About a company → companies/{name-slug}.md
  • A reusable concept/framework → concepts/{slug}.md
  • An original idea → originals/{slug}.md
  • A meeting → meetings/{slug}.md
  • Media content → media/{type}/{slug}.md
  • Raw data import → sources/{slug}.md
  1. Cross-link. Link from related directories.
  2. Check notability. See skills/conventions/quality.md notability gate.

Output Format

Advisory: "File this at {type}/{slug}.md because the primary subject is {reason}."

When it fails

Follow the agent operator protocol for any gbrain error code, exit code, [AGENT] block or notice block. Specific to this skill:

  • list_pages / search cannot find a matching directory or the brain is unreachable: fall back to skills/_brain-filing-rules.md and say the placement came from the rules, not the live brain.
  • get_page returns page_not_found for the page being filed: confirm the slug with the user before choosing a directory.

Anti-Patterns

  • Filing by format ("it's a PDF so it goes in sources/")
  • Filing by source ("it came from email so it goes in sources/")
  • Creating pages without checking if one already exists
  • Using sources/ for anything except raw data dumps
aus demselben Repository

Weitere Skills

Alle Skills
garrytan
Community

academic-verify

Verify a research claim or academic citation by tracing it through publication → methodology → raw data → independent replication. Routes through perplexity-research for the actual web lookup, then formats results as a citation-checked brain page. Use when a book/article/conversation cites a study and you want to confirm the claim is real, replicated, and accurately characterized.

Installationen / 1h
1
GitHub Stars
32.517
Aktualisiert
11. Nov.
garrytan
Community

ask-user

Reusable pattern for presenting the user with explicit choices and gating execution until they respond. Used by other skills when a decision point requires human input before proceeding. Platform-agnostic — works on Telegram (inline buttons), Discord, CLI, or any agent with a message tool.

Installationen / 1h
1
GitHub Stars
32.517
Aktualisiert
11. Nov.
garrytan
Community

brain-ingest-gate

Pre-write quality gate for content entering the brain. No raw copies: a bare cp/mv into the brain repo is a bug. Before any new page lands, resolve named entities registry-first (a vector score is a floor for prose, never a gate for named things), then run the read-the-top-hit dedup decision tree (clear-dup / plausible-dup / clear). Owns dedup; delegates enrichment to the shipped ingestion skills. Routing convention, not an operation-boundary enforcement.

Installationen / 1h
1
GitHub Stars
32.517
Aktualisiert
11. Nov.
garrytan
Community

brain-ops

Brain knowledge base operations. The core read/write cycle: brain-first lookup, read-enrich-write loop, source attribution, ambient enrichment, back-linking. Read this before any brain interaction.

Installationen / 1h
1
GitHub Stars
32.517
Aktualisiert
11. Nov.