garrytan/gbrain

repo-architecture

Where new brain files go.

Ver código-fonte

Como usar

  1. Copie o comando e verifique o pacote antes de instalar no seu ambiente de agente.
  2. Consulte no original as ferramentas, credenciais e ambientes necessários.
  3. Descreva os dados de entrada e a entrega esperada; confira a saída com as fontes.
npx skills add https://github.com/garrytan/gbrain --skill repo-architecture

Antes de começar

  • A instalação não inclui assinatura de modelo, franquia API ou acesso aos seus arquivos.
  • Estrelas e instalações indicam atividade, não um teste independente de qualidade ou segurança.
Documento original do Skill

Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.

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
do mesmo repositório

Mais Skills

Todos os Skills
garrytan
Comunidade

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.

Instalações / 1h
1
GitHub Stars
32,5 mil
Atualizado
11 de nov.
garrytan
Comunidade

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.

Instalações / 1h
1
GitHub Stars
32,5 mil
Atualizado
11 de nov.
garrytan
Comunidade

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.

Instalações / 1h
1
GitHub Stars
32,5 mil
Atualizado
11 de nov.
garrytan
Comunidade

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.

Instalações / 1h
1
GitHub Stars
32,5 mil
Atualizado
11 de nov.