跳到正文
cccskills
免费在 GitHub 公开

reference-pack

Learn how to author a third-party gbrain skillpack through a reference example. It explains required files, ten validation criteria, tests, and evaluation coverage, helping authors understand what to check before packaging and publishing.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

Reference skill demonstrating the 10/10 skillpack contract. Adds a "what does this skillpack do" answer to the user's agent.

查看安装方法

适用场景

  • Learning the structure of a gbrain skillpack
  • Checking requirements before publication
  • Understanding test and evaluation files
  • Reviewing fixes suggested by the validation command

包含的文件(2)

  • SKILL.md3.9 KB
  • routing-eval.jsonl415 B

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

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):

  1. unit_tests_present — manifest.unit_tests matches >= 1 file
  2. e2e_tests_present — manifest.e2e_tests matches >= 1 file
  3. llm_eval_present — *.judge.json with >= 3 cases
  4. bootstrap_runbook_present — non-empty runbooks/bootstrap.md
  5. 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.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Check research claims cited in books, articles, or conversations by tracing the original paper, methods, underlying data, and independent replication. Save a sourced assessment explaining whether the claim holds up and what remains uncertain.

中文简介正在准备中。当前显示英语简介。

  • Check a study cited in a book
  • Trace a numerical claim in an article to its source data
  • Verify research evidence before using it in writing
garrytan/gbrain3.1万2026年10月20日 更新

Explore old files and email archives to rediscover personal writing, ideas, and meaningful conversations. Review selected items one at a time, save worthwhile material as organized notes, and track progress within explicitly permitted folders.

中文简介正在准备中。当前显示英语简介。

  • Rediscover old journals and creative writing
  • Find meaningful letters and email conversations
  • Recover past product and business ideas
garrytan/gbrain3.1万2026年10月20日 更新

Restructure raw article text stored in gbrain into summaries, exact quotes, key insights, and links to related pages. Preserve the original text and connect the article's significance to projects and interests already recorded in gbrain.

中文简介正在准备中。当前显示英语简介。

  • Organizing saved articles into readable notes
  • Collecting exact quotes for essays
  • Connecting articles to current projects
garrytan/gbrain3.1万2026年10月20日 更新

ask-user

免费

Present clear choices when a task needs a human decision, then pause execution until the user replies. This reusable interaction pattern supports filing decisions, priority selection, and confirmation before destructive actions, with an option to decline.

中文简介正在准备中。当前显示英语简介。

  • Clarifying requests with several possible meanings
  • Confirming before bulk deletion or overwriting
  • Choosing where to file meeting notes
garrytan/gbrain3.1万2026年10月20日 更新

Collect public posts across a blog, newsletter, or feed archive and save clean Markdown pages for each article. The workflow avoids duplicates, supports resumed runs, repairs empty results, and hands articles to a separate enrichment skill.

中文简介正在准备中。当前显示英语简介。

  • Importing a blog's public article archive
  • Organizing public newsletter posts as knowledge pages
  • Rerunning a feed import without duplicates
garrytan/gbrain3.1万2026年10月20日 更新

Create a detailed chapter-by-chapter reading companion from an EPUB or PDF, connecting the book’s ideas to experiences and words saved in your personal knowledge store. The result highlights parallels without prescribing actions.

中文简介正在准备中。当前显示英语简介。

  • Connect a book’s ideas to personal experiences
  • Review detailed chapter summaries alongside personal reflections
  • Create a parent’s guide for reading a children’s book aloud
garrytan/gbrain3.1万2026年10月20日 更新

查看 garrytan 的全部技能

报告此技能的问题