configure-pi-session-tools SKILL.md skillA
configure-pi-session-tools from maplezzk/pi-extensions is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add maplezzk/pi-extensions/configure-pi-session-tools@git:20260922.81dfc83Pins git:20260922.81dfc83 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-session-tools/SKILL.md- Versions recorded
- 6
- Latest version
- git:20260922.81dfc83, committed Sep 22, 2026
- First version recorded
- Aug 27, 2026
- Size
- 3,660 bytes
- Repository stars
- 20
- License
- MIT
配置与排查 session squash 提醒阈值、强制压缩比例和 bash 管道缓存。Use when configuring pi-session-tools context management.
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-session-tools ## 诊断 读取实际 Pi agent 目录下的 `extensions/pi-session-tools/config.json`，并检查 `PI_SESSION_TOOLS_SQUASH_THRESHOLDS`。配置字段： - `squashContextThresholds`：数字、`150k` 或 `75%` 可混合； - `forceSquashContextThreshold`：`0` 到 `1` 的 JSON 数字，`null` 表示关闭。 环境变量只配置提醒阈值，不配置强制比例。 ## 修改 优先使用 `/config:session-tools`；`/pi-session-tools` 是兼容别名。不带参数时打开配置面板：面板上「强制压缩比例」是候选列表（回车打开二级列表，含「关闭强制」与常见比例），「提醒阈值」是自由文本（回车打开预填当前值的输入框）。改动立即写盘并同步运行期状态，无需 `/reload`；关闭强制会立即退出强制模式并恢复工具。 也可以用命令参数直接修改。强制模式使用 `/config:session-tools force 0.9`，关闭使用 `force off`。不要给强制比例写 `"90%"` 字符串。 提醒阈值只在正常停止且跨过阈值时提示。强制阈值达到后只开放 `session_log` 与 `session_squash`，直到压缩成功；不要绕过或静默关闭。 ## 验证 - 配置后回读 JSON，确认类型和值未被归一化成意外形式。 - 压缩时先调用 `session_log`，再把完整任务状态快照直接传给 `session_squash`；没有独立 finalize 步骤。summary 支持自由格式，不会因缺少标题、章节或 `User`/`Agent` 时间线而拒绝压缩；如需便于接手，可按 handoff 结构组织。若未提供标题或时间线，扩展会自动补齐一份标题或紧凑事实时间线；自动时间线只保留 User 与 Agent 文本，不记录工具调用或工具结果。任务或阶段到达安全停点即可压缩，无需等整个任务结束。已作为压缩起点保留的 user anchor 会继续返回；若上次快照后、下一条 user turn 前产生了自动续接内容，应复用该锚点重新压缩。用户纠正优先于 Agent 推断；未证实内容标记 `INFERRED`、`UNKNOWN`、`NOT VERIFIED` 或 `BLOCKED`；不要记录压缩、阈值或会话切换过程，也不要让已完成工作再次进入下一步。每次压缩都必须显式选择接续模式：仍有可立即执行的工作时设置 `continuation: "auto"`；任务已完成或 Resume 依赖用户尚未确认的信息时设置 `continuation… …
Read the whole file at its exact version.
How to install
mdr add maplezzk/pi-extensions/configure-pi-session-tools@sha256:7d1f8b8fb4f57db8The line at the top of this page pins the label git:20260922.81dfc83, 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.
[](https://markdownregistry.com/a/art_gqhljcsye5afnrcp)
5 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 6 versions of this file, between Aug 27, 2026 and Sep 22, 2026, about one every 5 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260922.81dfc83 latest | 2026-09-22 | 81dfc83 | 3,660 B | A | view · diff |
| git:20260919.5782c68 | 2026-09-19 | 5782c68 | 3,261 B | A | view · diff |
| git:20260918.fcf36bd | 2026-09-18 | fcf36bd | 2,817 B | A | view · diff |
| git:20260903.d38bd4d | 2026-09-03 | d38bd4d | 2,623 B | A | view · diff |
| git:20260901.489ae8f | 2026-09-01 | 489ae8f | 2,535 B | A | view · diff |
| git:20260827.14362f2 | 2026-08-27 | 14362f2 | 2,884 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (3660 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
maplezzk/pi-extensions · 20 stars · license MIT · pushed 2026-11-06 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_gqhljcsye5afnrcp GET https://markdownregistry.com/api/v1/resolve?ref=maplezzk/pi-extensions/configure-pi-session-tools GET https://markdownregistry.com/api/v1/blob/7d1f8b8fb4f57db8a08bffc61ce4b66f46adcda13393e9c88bf897b70cb977cd
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.