reference-pack

The canonical 10/10 reference for a third-party gbrain skillpack. This pack ships inside gbrain's own repo at examples/skillpack-reference/ and doubles as an integration-test fixture (gbrain skillpack doctor examples/skillpack-reference --quick is wired into CI; the score must stay at 10/10 forever).

If you're authoring a new skillpack: read this tree top to bottom, then run gbrain skillpack init <your-name> to scaffold the same shape into a new directory.

Install (illustrative)

Third parties who fork this layout publish to their own GitHub repo, then users scaffold from there:

gbrain skillpack scaffold your-user/skillpack-<name>

scaffold lands the files additively (refuses to overwrite), records the install in ~/.gbrain/skillpack-state.json with the pinned commit SHA, then displays runbooks/bootstrap.md (no executor — codex T1).

What this pack adds to the user's agent

A single skill (skills/reference-pack/) that explains the third-party skillpack contract when the user asks. The skill is illustrative; real packs add useful behavior (judge a hackathon, score a founder, etc.).

Tree map

examples/skillpack-reference/
├── skillpack.json                  # manifest (cathedral fields declared)
├── skills/
│   └── reference-pack/
│       ├── SKILL.md                # frontmatter + body, agent-readable
│       └── routing-eval.jsonl      # 5 intents pinning trigger -> skill
├── runbooks/
│   └── bootstrap.md                # post-scaffold display (no executor)
├── test/
│   └── example.test.ts             # unit test stub (bun:test)
├── e2e/
│   └── example.e2e.test.ts         # E2E stub, gated on DATABASE_URL
├── evals/
│   └── reference-pack.judge.json   # LLM-judge eval, 3 cases minimum
├── CHANGELOG.md                    # Keep-a-Changelog
├── LICENSE                         # SPDX-matching license text
├── README.md                       # this file
└── .gitignore

Doctor verdict

gbrain skillpack doctor examples/skillpack-reference --quick should always print:

★ reference-pack@<version>  10/10  [endorsed]

A regression test (test/skillpack-init-pack.test.ts:e2e-init-doctor-pack) pins this contract: any change that drops the reference pack below 10/10 fails the build. That's the invariant — gbrain ships its own bar.