configure-pi-distill SKILL.md skillA

configure-pi-distill from maplezzk/pi-extensions is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add maplezzk/pi-extensions/configure-pi-distill@git:20261007.3cd5266

Pins git:20261007.3cd5266 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
maplezzk/pi-extensions
Path
packages/pi-distill/SKILL.md
Versions recorded
3
Latest version
git:20261007.3cd5266, committed Oct 7, 2026
First version recorded
Aug 20, 2026
Size
2,263 bytes
Repository stars
20
License
MIT

配置与排查 pi-distill 的模型、压缩阈值、重试、工具开关和审计卡片。Use when configuring pi-distill or diagnosing output distillation.

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

# 配置 pi-distill

## 诊断

1. 定位实际 Pi agent 目录;默认是 `~/.pi/agent`,设置 `PI_CODING_AGENT_DIR` 时使用该目录。
2. 读取 `extensions/pi-distill/config.json`;不存在时从包内 `config.example.json` 建立,不猜字段。
3. 同时检查 `PI_DISTILL_*` 和旧 `PI_BASH_SUMMARY_*` 环境变量。JSON 配置优先;环境变量中同名的新 `PI_DISTILL_*` 优先于旧 `PI_BASH_SUMMARY_*`。

## 修改

优先让用户在 Pi 中运行 `/config:distill`;`/pi-distill` 只是兼容别名。不带参数时打开设置面板(开关原地切换,枚举与模型走二级列表,模型可搜索、可手输),改一项立即写盘并对本次会话生效,不需要 `/reload`。带参数时不打开面板:`enable`、`disable`、`status`。

手工配置时只使用包内 `config.example.json` 已声明的字段:

- `model` 留空时使用当前会话模型,否则必须是可用的 `provider/model`;
- `minChars` 控制何时提炼,`maxChars` 与 `maxOutputChars` 控制大结果落盘和返回上限;
- `timeoutRetryCount`、`errorRetryCount` 是额外重试次数;
- `summarizeErrors` 默认 `true`,控制达到 `minChars` 的错误结果是否提炼;环境变量依次为 `PI_DISTILL_SUMMARIZE_ERRORS`、旧 `PI_BASH_SUMMARY_SUMMARIZE_ERRORS`;
- `tools.<name>.enabled` 控制单个工具;`edit`、`write` 默认关闭,其他未配置工具默认开启;`codemode` 无法注入,开关对它无效,也不出现在面板里。
- `render` 只控制展示,不改变提炼语义。

不要把需要完整原文的调用配置成摘要;调用方应传 `outputRequest: "RAW"`。不要为非文本结果启用文本提炼假设。

## 验证

- 用 `/distill:stats` 查看当前会话成功、失败、回退、压缩率和模型消耗。
- 对达到 `minChars` 的文本工具结果观察提炼;再用 `RAW` 确认完整性路径。
- 当前会话无可用模型或模型调用失败时,必须报告原始结果被保留的 fail-open 行为,不能宣称提炼成功。

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add maplezzk/pi-extensions/configure-pi-distill@sha256:edfe3e6a6b7b6141

The line at the top of this page pins the label git:20261007.3cd5266, 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_mtdnx6ucrxviypod.svg)](https://markdownregistry.com/a/art_mtdnx6ucrxviypod)

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

Versions

The registry has recorded 3 versions of this file, between Aug 20, 2026 and Oct 7, 2026, about one every 24 days.

versioncommittedcommitsizeaudit
git:20261007.3cd5266 latest2026-10-07 3cd5266 2,263 BA view · diff
git:20260922.80293b52026-09-22 80293b5 2,189 BA view · diff
git:20260820.57a98632026-08-20 57a9863 1,930 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the 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 (2263 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

maplezzk/pi-extensions · 20 stars · license MIT · pushed 2026-11-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mtdnx6ucrxviypod
GET https://markdownregistry.com/api/v1/resolve?ref=maplezzk/pi-extensions/configure-pi-distill
GET https://markdownregistry.com/api/v1/blob/edfe3e6a6b7b614146ecaa847fbda6f5effd0ff447db94ba87731485de3188c5

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 maplezzk/pi-extensions

AGENTS.md AGENTS.md file
maplezzk/pi-extensions · AGENTS.md
git:20260922.1612473 · audit A · 20 stars
configure-pi-auto-goal SKILL.md skill
maplezzk/pi-extensions · packages/pi-auto-goal/SKILL.md · 配置与排查 pi-auto-goal 的提前停止判定、判定模型、干预上限与催促文案。Use when configuring or diagnosing premature-stop judgement.
git:20260922.a62090b · audit A · 20 stars
configure-pi-clean-mode SKILL.md skill
maplezzk/pi-extensions · packages/pi-clean-mode/SKILL.md · 配置与排查 pi-clean-mode 的配置面板、折叠单位、耗时头、自动展开与快捷键。Use when configuring clean mode, opening its settings panel, or diagnosing…
git:20261006.3c36c0d · audit A · 20 stars
configure-pi-dynamic-workflows SKILL.md skill
maplezzk/pi-extensions · packages/pi-dynamic-workflows/SKILL.md · 配置与排查 pi-dynamic-workflows 的执行后端和异步模式。Use when configuring workflow backend, async mode, or subagent integration.
git:20260922.07de307 · audit A · 20 stars
configure-pi-extensions-i18n SKILL.md skill
maplezzk/pi-extensions · packages/pi-extensions-i18n/SKILL.md · 配置 Pi 扩展共享语言并排查 locale 优先级、持久化设置和 catalog。Use when changing zh-CN/en-US/auto language behavior.
git:20260922.c7d696c · audit A · 20 stars
configure-pi-extensions-tool-display SKILL.md skill
maplezzk/pi-extensions · packages/pi-extensions-tool-display/SKILL.md · 配置与排查 Pi 工具展示宿主、内建/自定义工具 override、输出模式和 diff 视图。Use when changing pi-extensions-tool-display rendering.
git:20260820.57a9863 · audit A · 20 stars
configure-pi-gen-ui SKILL.md skill
maplezzk/pi-extensions · packages/pi-gen-ui/SKILL.md · 配置与排查 pi-gen-ui 的面板渲染、交互面板、结果行数上限与 Jev 组合。Use when configuring json-render panels or diagnosing render_ui/compose_ui.
git:20261005.f7aef84 · audit A · 20 stars
configure-pi-interactive-subagents SKILL.md skill
maplezzk/pi-extensions · packages/pi-interactive-subagents/SKILL.md · 配置与排查 interactive subagents 的终端复用器、Herdr split/tab 和状态面板。Use when configuring subagent mux behavior.
git:20260918.137b800 · audit A · 20 stars
configure-pi-metrics SKILL.md skill
maplezzk/pi-extensions · packages/pi-metrics/SKILL.md · 启用与排查 pi-metrics 的耗时、TPS、TTFT、token 和成本遥测。Use when configuring or diagnosing Pi session metrics.
git:20260922.07de307 · audit A · 20 stars
configure-pi-models-discovery SKILL.md skill
maplezzk/pi-extensions · packages/pi-models-discovery/SKILL.md · 配置与排查 models.json 的动态模型发现、缓存刷新、鉴权和离线回退。Use when adding discoverModels providers or refreshing model catalogs.
git:20261106.4058f39 · audit A · 20 stars
configure-pi-naming SKILL.md skill
maplezzk/pi-extensions · packages/pi-naming/SKILL.md · 配置 Pi 统一 /rename、首条消息命名和终端目标归属。Use when configuring pi-naming.
git:20261017.d758347 · audit A · 20 stars
configure-pi-nested-skills SKILL.md skill
maplezzk/pi-extensions · packages/pi-nested-skills/SKILL.md · 配置与排查 pi-nested-skills 的技能根目录、递归发现、别名调用和补全。Use when configuring nested skill roots, aliases, discovery, or completion.
git:20260922.e07845b · audit A · 20 stars

Every file in maplezzk/pi-extensions

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