gemma4-local-deploy SKILL.md skillB

gemma4-local-deploy from majiayu000/spellbook is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add majiayu000/spellbook/gemma4-local-deploy@git:20260716.c59c99d

Pins git:20260716.c59c99d in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
majiayu000/spellbook
Path
skills/gemma4-local-deploy/SKILL.md
Versions recorded
5
Latest version
git:20260716.c59c99d, committed Jul 16, 2026
First version recorded
Jun 4, 2026
Size
5,651 bytes
Repository stars
290
License
MIT

在本机 Mac 或 Apple Silicon 上部署 Gemma 4 12B。本地安装/升级 llama.cpp,下载 GGUF 量化模型,用 llama-server 暴露 OpenAI-compatible API,或用 Ollama 暴露本地模型服务;按用户需求在默认 Q4_K_M、64K/128K 长上下文、QAT Q4_0 @ 256K、左右对比演示之间选择,配置 tmux 后台运行,验证健康检查、问答接口、资源占用和常见故障。当用户说部署 Gemma 4、Gemma 4 12B、本地大模型、长上下文、QAT、量化、llama-server、Ollama、GGUF、Mac 本地模型服务时使用。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Gemma 4 12B 本地部署

把 Gemma 4 12B 的 GGUF 版本部署成本机模型服务。默认使用 `llama.cpp` / `llama-server`、Apple Metal、`Q4_K_M` 和 `tmux`,只监听 loopback;用户明确要求 QAT、256K、对比演示或 Ollama 时才切换路线。

## Operating Contract

- Direct actions: 读取本机硬件、磁盘、端口、进程和模型缓存;在用户已要求本地部署时,安装或升级明确的软件包、下载选定模型、创建专用模型目录和 tmux 会话,并只绑定 `127.0.0.1`。
- Escalate before: 停止不属于本 Skill 的现有进程、覆盖已有模型或配置、删除用户数据、监听公网地址、改变防火墙,或下载用户未选择的大型模型变体。
- Evidence-backed pushback: 如果用户指定的模型标签、上下文、内存预算或本机能力与当前可验证状态冲突,先展示命令输出并提出可运行的 profile,不伪造支持状态。
- Feedback loop: 现状检查 → 选择并复述 profile → 执行一条部署路线 → 当前会话完成健康、模型和聊天验证 → 报告端点、资源与限制。

## 默认选择

- 默认模型仓库:`ggml-org/gemma-4-12B-it-GGUF`
- 默认量化:`Q4_K_M`
- 默认模型名:`gemma-4-12b-it`
- 默认端点:`http://127.0.0.1:8080`
- 默认上下文:`32768`
- 12B 长上下文:用户明确要求时选择 `65536` 或 `131072`
- QAT 仓库:`google/gemma-4-12B-it-qat-q4_0-gguf`
- QAT profile:`Q4_0`、`262144` 上下文
- 默认后台会话:`gemma4-12b`
- 默认关闭 thinking:`--reasoning off`,避免 OpenAI API 的 `message.content` 为空
- Ollama:只在用户明确要求 Ollama 或需要 Ollama 生态时使用

QAT 是训练时模拟量化,不等于无损。关键任务仍要用当前会话的真实响应验证。用户明确要更高质量时,优先建议 `Q6_K` 或 `Q8_0`;除非用户接受更高内存和更慢加载,不默认使用 `bf16`。

## Profile 选择

| Profile | 适用场景 | Model / quant | Context | Port / alias |
|---|---|---|---:|---|
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add majiayu000/spellbook/gemma4-local-deploy@sha256:022825c3434c8268

The line at the top of this page pins the label git:20260716.c59c99d, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

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

6 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Jun 4, 2026 and Jul 16, 2026, about one every 11 days.

versioncommittedcommitsizeaudit
git:20260716.c59c99d latest2026-07-16 c59c99d 5,651 BB view · diff
git:20260606.60091e12026-06-06 60091e1 13,997 BC view · diff
git:20260605.a09e45c2026-06-05 a09e45c 10,536 BC view · diff
git:20260604.a4346ab2026-06-04 a4346ab 10,380 BC view · diff
git:20260604.f9fae852026-06-04 f9fae85 8,229 BB view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No link to a raw IP address (matched: http://127.0.0.1:8080)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5651 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 script tag

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

majiayu000/spellbook · 290 stars · license MIT · pushed 2026-11-04 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ex2kjspv2evalajr
GET https://markdownregistry.com/api/v1/resolve?ref=majiayu000/spellbook/gemma4-local-deploy
GET https://markdownregistry.com/api/v1/blob/022825c3434c826815c9d6c3acc4873ec7ceead0e2d271f6a4abf429609059dc

Your AI assistant 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.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from majiayu000/spellbook

AGENTS.md AGENTS.md file
majiayu000/spellbook · AGENTS.md
git:20260630.1f0cf93 · audit A · 290 stars
idea-analogist SKILL.md skill
majiayu000/spellbook · plugins/idea-coach/skills/idea-analogist/SKILL.md · 想法群聊室 — 类比者角色。被 idea-team 主编排器调用,或用户单独说"类比一下"、"别的行业有没有"、"yes-and 扩展"、"X 让你想到什么"、"跨界启示"时触发。**专门做跨界类比 + yes-and…
git:20260820.304ca2f · audit A · 290 stars
idea-devils-advocate SKILL.md skill
majiayu000/spellbook · plugins/idea-coach/skills/idea-devils-advocate/SKILL.md · 想法群聊室 — 反方角色。被 idea-team 主编排器调用,或用户单独说"反方意见"、"挑这个想法的刺"、"为什么会失败"、"找漏洞 / 反例"、"devil's…
git:20260820.304ca2f · audit A · 290 stars
idea-research SKILL.md skill
majiayu000/spellbook · plugins/idea-coach/skills/idea-research/SKILL.md · 想法群聊室 — 调研员角色。被 idea-team 主编排器调用,或用户单独说"调研一下 X"、"X 的现状/竞品/数据"、"找 2026 数据"、"事实底"时触发。**用 WebSearch 拉真实 2026…
git:20260820.304ca2f · audit A · 290 stars
idea-team SKILL.md skill
majiayu000/spellbook · plugins/idea-coach/skills/idea-team/SKILL.md · 想法群聊室主持人 — 把一句话想法丢给多角色 AI 团队(调研员/反方/类比者)做查漏补缺。每个角色有自己的 voice,他们互相 @ 接话;你随时插话。**这是创意扩展工具,不打分、不否决、不堵路**。Use when…
git:20260820.304ca2f · audit A · 290 stars
idea-to-product SKILL.md skill
majiayu000/spellbook · plugins/idea-coach/skills/idea-to-product/SKILL.md · 端到端产品教练 — 把一句话想法走到 PRD + 可点击 HTML 原型。会顶嘴、强制砍功能、用 Nielsen + Norman 做友好性硬检。Use when user 说"我有一个想法"、"想做一个产品"、"做 MVP"、"写…
git:20260820.304ca2f · audit A · 290 stars
app-ui-design SKILL.md skill
majiayu000/spellbook · plugins/spellbook-ui/skills/app-ui-design/SKILL.md · Mobile app UI design expert for iOS and Android. Use when designing app interfaces, creating design systems, ensuring…
git:20260831.f1a2f17 · audit A · 290 stars
figma-to-react SKILL.md skill
majiayu000/spellbook · plugins/spellbook-ui/skills/figma-to-react/SKILL.md · Use when the user wants to extract Figma designs into production-ready React or Next.js components with TypeScript…
git:20260831.f1a2f17 · audit A · 290 stars
frontend-design SKILL.md skill
majiayu000/spellbook · plugins/spellbook-ui/skills/frontend-design/SKILL.md · Create distinctive, production-grade web frontend interfaces with high design quality. Use when the user explicitly…
git:20260831.f1a2f17 · audit A · 290 stars
ui-design-system SKILL.md skill
majiayu000/spellbook · plugins/spellbook-ui/skills/ui-design-system/SKILL.md · Use when creating or maintaining UI design systems, design tokens, component documentation, responsive calculations…
git:20260831.f1a2f17 · audit A · 290 stars
AGENTS.md@registry AGENTS.md file
majiayu000/spellbook · registry/AGENTS.md
git:20260623.1378532 · audit A · 290 stars
AGENTS.md@scripts AGENTS.md file
majiayu000/spellbook · scripts/AGENTS.md
git:20260623.1378532 · audit A · 290 stars

Every file in majiayu000/spellbook

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