# Reference Pack

> Skill de referencia que demuestra el contrato de skillpack 10/10 y añade a tu agente la respuesta a 'qué hace este skillpack'.

Fuente: https://skillsagentes.com/skills/garrytan/gbrain/reference-pack
Markdown: https://skillsagentes.com/skills/garrytan/gbrain/reference-pack.md

Repositorio: https://github.com/garrytan/gbrain
Autor: garrytan
Licencia: MIT
Actualizado: hace 3 meses
Coste de contexto: 31 tok instalada, 997 tok al activarse, 1.1k tok con todos los archivos del bundle
Bundle: 2 archivos, 4 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add garrytan/gbrain --skill reference-pack --agent claude-code
# Cursor
npx -y skills add garrytan/gbrain --skill reference-pack --agent cursor
# Codex
npx -y skills add garrytan/gbrain --skill reference-pack --agent codex
# Gemini CLI
npx -y skills add garrytan/gbrain --skill reference-pack --agent gemini
# Windsurf
npx -y skills add garrytan/gbrain --skill reference-pack --agent windsurf
# Cline
npx -y skills add garrytan/gbrain --skill reference-pack --agent cline
```

## Qué hace

- Explica qué es un skillpack de gbrain de terceros y los cuatro artefactos que debe incluir
- Detalla las 10 dimensiones binarias que evalúa `gbrain skillpack doctor`
- Explica los niveles de elegibilidad (endorsed, community, experimental, blocked)
- Indica cómo ejecutar `doctor` y `pack` para publicar un skillpack

## Cuándo usarla

- El usuario pregunta qué es el skillpack de referencia o cómo funcionan los skillpacks de terceros
- El usuario pregunta qué es un skillpack 10/10 o cómo funciona el contrato de skillpacks

## Qué la activa

- "¿Qué es el skillpack de referencia?"
- "Explícame el contrato de skillpacks"
- "¿Cómo funcionan los skillpacks de terceros en gbrain?"
- "¿Qué es un skillpack 10/10?"

## Antes de instalar

- Requiere la CLI `gbrain` para ejecutar `skillpack doctor` y `skillpack pack`.

## Archivos

- SKILL.md — 4 KB
- routing-eval.jsonl — 415 B

## SKILL.md

Reproducido tal cual desde garrytan/gbrain bajo MIT. Esta sección es el documento original y está en inglés.

# reference-pack

This is the canonical reference for a third-party gbrain skillpack. Read
its tree once and you know how to author one.

## What this skill does

When the user asks how third-party gbrain skillpacks work, this skill
points them at the four artifacts every pack ships:

- `skillpack.json` — declares pack metadata + which artifacts the
  doctor scores (skills, unit_tests, e2e_tests, llm_evals, routing_evals,
  runbooks, changelog).
- `skills/<name>/SKILL.md` — frontmatter (name, description, mutating,
  triggers) plus markdown body. Agents route on `triggers:`; the body
  is the in-context instruction set.
- `runbooks/bootstrap.md` — agent-readable post-scaffold steps. gbrain
  DISPLAYS this after `scaffold` lands; the agent walks per-step at
  its own discretion. No auto-executor (codex T1 supply-chain hardening).
- `CHANGELOG.md` — Keep-a-Changelog shape. The doctor's `changelog_
  present_and_current` dimension fails if there's no `## [<version>]`
  entry matching the manifest's `version`.

## What the doctor scores

Ten binary dimensions, split into:

**Core (5; must all pass to publish at any tier):**

1. `manifest_valid` — schema-validates skillpack.json
2. `skills_have_skill_md` — every listed skill has SKILL.md with
   name / description / triggers
3. `routing_evals_present` — each skill has routing-eval.jsonl with
   >= 5 intents
4. `skills_have_unique_triggers` — MECE at the pack level
5. `changelog_present_and_current` — CHANGELOG entry for current version

**Quality badges (5; earn for tier eligibility):**

6. `unit_tests_present` — manifest.unit_tests matches >= 1 file
7. `e2e_tests_present` — manifest.e2e_tests matches >= 1 file
8. `llm_eval_present` — `*.judge.json` with >= 3 cases
9. `bootstrap_runbook_present` — non-empty runbooks/bootstrap.md
10. `license_present` — LICENSE / LICENSE.md / LICENSE.txt non-empty

Tier eligibility:

- `endorsed` — all 10 (gates: Garry's `endorsements.json` overlay
  in the registry)
- `community` — all 5 core + >= 3 of 5 badges (default tier on PR
  merge)
- `experimental` — all 5 core + < 3 badges
- `blocked` — any core fails

Run `gbrain skillpack doctor <pack-dir>` to see exactly which
dimensions a candidate pack passes and the paste-ready fix for each
failure. `--fix --yes` auto-scaffolds the dimensions flagged
`auto_fixable: true` (routing-eval stubs, CHANGELOG entries,
license stub, bootstrap stub, test stubs).

## How agents use this skill

The triggers above route any "what is a skillpack" / "how do third-
party packs work" user phrasing to THIS skill. The agent reads the
markdown body, then either answers the user's question directly or
calls `gbrain skillpack info <name>` / `search <query>` for live
registry data.

## Test + eval coverage

- `test/example.test.ts` — unit test that imports the skill helper
  (stub; replace with real assertions).
- `e2e/example.e2e.test.ts` — integration test gated on DATABASE_URL.
- `evals/reference-pack.judge.json` — LLM-judge eval scoring this
  skill's output against the "does it actually teach the contract"
  bar across happy-path / edge / failure-mode cases.
- `skills/reference-pack/routing-eval.jsonl` — five phrasings users
  ask, all mapped to `expected_skill: reference-pack`.

## Author's checklist

Before pushing, the publisher runs:

```
gbrain skillpack doctor . --quick --json
gbrain skillpack pack
```

The first hits the rubric and prints paste-ready fixes for any failed
dimension. The second emits `reference-pack-<version>.tgz` with a
deterministic SHA-256 the publisher submits to the registry PR.

## Dónde encaja

- Categoría: [Herramientas para desarrolladores](https://skillsagentes.com/categorias/herramientas-desarrollo.md) — Skills que cambian cómo tu agente escribe, revisa y despliega código.
- Creador: [garrytan](https://skillsagentes.com/creators/garrytan.md) — 134 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Setup](https://skillsagentes.com/skills/garrytan/gbrain/setup.md): Configura GBrain con auto-aprovisionamiento de Supabase o PGLite, inyección en AGENTS.md y primera importación.
- [Maintain](https://skillsagentes.com/skills/garrytan/gbrain/maintain.md): Chequeos de salud del brain: aplicación de back-links, auditoría de citas, validación de filing, detección de info obsoleta, páginas huérfanas y benchmarks.
- [Schema Unify](https://skillsagentes.com/skills/garrytan/gbrain/schema-unify.md): Migra un brain de gbrain-base a la taxonomía de 14 tipos canónicos de gbrain-base-v2 usando gbrain onboard --check y el handler Minion unify-types.
- [Retrieval Reflex](https://skillsagentes.com/skills/garrytan/gbrain/retrieval-reflex.md): Cuándo y qué recuperar: abre la página del brain de una entidad relevante antes de responder desde memoria.
- [Minion Orchestrator](https://skillsagentes.com/skills/garrytan/gbrain/minion-orchestrator.md): Skill unificado de Minions para jobs deterministas de shell y orquestación de subagentes LLM: cola durable, observable y controlable, más la doctrina de ejecución durable para operaciones largas.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)