Home / garrytan / gbrain · plugin-variants/gbrain-coding/skills/brain-link-discipline/SKILL.md · GitHub

brain-link-discipline skillA

brain-link-discipline is agent-read markdown (skill) from garrytan/gbrain: When you report a brain page to the user — created, edited, committed, or relayed from a subagent — a working link is part of the deliverable, in the SAME message. Derive the path mechanically (git ls-files --full-name), push BEFORE linking, verify the link resolves when a hosted remote exists, and degrade through a defined fallback chain when it doesn't. Inside brain pages the rule inverts: relative links preserve the link graph; absolute URLs are for chat deliverables only..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# brain-link-discipline — The Link Is Part of the Deliverable

> **Convention:** see [_output-rules.md](../_output-rules.md) — the
> Deterministic Links section carries the cross-skill canon (in-page relative
> vs in-message verified, plus the fallback chain). This skill carries the
> mechanics: path derivation, push-before-link ordering, verification, the
> subagent-relay rewrite, and bulk-list formatting.
>
> **Convention:** [conventions/brain-first.md](../conventions/brain-first.md)
> states the one-line principle ("every brain page reference in output should
> use a clickable link format appropriate to the deployment"). This skill is
> that line's full expansion.

This is a reporting convention the harness routes brain-page delivery
messages through — a standing rule to apply when composing such messages,
not a mechanical guarantee enforced by tooling.

## The rule (same message)

If you commit and push a brain page, the link goes in the SAME message that
reports the work. Every time. No "let me commit and push" without the link
landing in that same reply once the push succeeds. The user should never
have to ask "give me the link" or "where is the page."

This applies to:
…

Read the whole file at its exact version.

How to install

Latest version
mdr add garrytan/gbrain/brain-link-discipline@v1.0.0
Exact content
mdr add garrytan/gbrain/brain-link-discipline@sha256:489268f71a01abb6

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_3qa5k3xrgbmod54h.svg)](https://markdownregistry.com/a/art_3qa5k3xrgbmod54h)

2 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
v1.0.0 latest2026-08-17 489e277 11,889 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (11889 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

garrytan/gbrain · 30,275 stars · license MIT · pushed 2026-09-23 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_3qa5k3xrgbmod54h
GET https://markdownregistry.com/api/v1/resolve?ref=garrytan/gbrain/brain-link-discipline
GET https://markdownregistry.com/api/v1/blob/489268f71a01abb6213df8a8bb5f4d16d587b09dd670ac3c47876a8ed808b5ae

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from garrytan/gbrain

AGENTS.md agents
garrytan/gbrain · AGENTS.md
git:20260921.6ebc629 · audit B · 30,275 stars
CLAUDE.md claude
garrytan/gbrain · CLAUDE.md
git:20260921.6ebc629 · audit A · 30,275 stars
DESIGN.md design
garrytan/gbrain · DESIGN.md
git:20260519.3a0e111 · audit A · 30,275 stars
DESIGN.md@admin design
garrytan/gbrain · admin/DESIGN.md
git:20260503.f082501 · audit A · 30,275 stars
gbrain skill
garrytan/gbrain · docs/integrations/qm-harness-snippets/SKILL.md · Search and write the company knowledge brain. Use for any question about the org, people, projects, decisions, or…
git:20260801.aff34a4 · audit A · 30,275 stars
reference-pack skill
garrytan/gbrain · examples/skillpack-reference/skills/reference-pack/SKILL.md · Reference skill demonstrating the 10/10 skillpack contract. Adds a "what does this skillpack do" answer to the user's…
git:20260520.bc9f777 · audit A · 30,275 stars
llms-full.txt llmstxt
garrytan/gbrain · llms-full.txt
git:20260921.6ebc629 · audit F · 30,275 stars
llms.txt llmstxt
garrytan/gbrain · llms.txt
git:20260921.6ebc629 · audit A · 30,275 stars
brain-ingest-gate skill
garrytan/gbrain · plugin-variants/gbrain-coding/skills/brain-ingest-gate/SKILL.md · Pre-write quality gate for content entering the brain. No raw copies: a bare cp/mv into the brain repo is a bug. Before…
v1.0.0 · audit A · 30,275 stars
brain-ops skill
garrytan/gbrain · plugin-variants/gbrain-coding/skills/brain-ops/SKILL.md · Brain knowledge base operations. The core read/write cycle: brain-first lookup, read-enrich-write loop, source…
v1.2.0 · audit A · 30,275 stars
concept-synthesis skill
garrytan/gbrain · plugin-variants/gbrain-coding/skills/concept-synthesis/SKILL.md · Deduplicate and synthesize raw concept stubs into a tiered intellectual map (T1 Canon to T4 Riff), tracing idea…
v0.2.0 · audit A · 30,275 stars
context-audit skill
garrytan/gbrain · plugin-variants/gbrain-coding/skills/context-audit/SKILL.md · Token-hygiene audit of the always-loaded context stack — CLAUDE.md, AGENTS.md, auto-memory MEMORY.md, and the…
v1.0.0 · audit A · 30,275 stars

Every file in garrytan/gbrain

Browse by kind, by grade A, or by owner.