configure-pi-notifications SKILL.md skillA
configure-pi-notifications 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-notifications@git:20260922.e07845bPins git:20260922.e07845b 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-notifications/SKILL.md- Versions recorded
- 4
- Latest version
- git:20260922.e07845b, committed Sep 22, 2026
- First version recorded
- Sep 5, 2026
- Size
- 2,670 bytes
- Repository stars
- 20
- License
- MIT
配置与排查 pi-notifications 的外部通知命令、argv 参数、超时和一次性失败提示。Use when configuring or diagnosing Pi external notifications.
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-notifications
## 配置文件
读取实际 Pi agent 目录下的 `extensions/pi-notifications/config.json`。不存在时使用内置默认配置；不要猜测未列出的字段。可以从包内 `config.example.json` 开始。
配置字段：
- `enabled`：布尔值，默认 `true`。
- `adapter.command`：通知可执行文件名或路径，默认 `terminal-notifier`。
- `adapter.args`：argv 字符串数组；支持 `{title}`、`{subtitle}`、`{message}` 占位符。
- `timeoutMs`：正整数，默认 `3000`。
手动改配置文件后执行 `/reload`。配置文件损坏会明确提示，并使用默认配置继续启动。
使用 `/config:notifications` 在 TUI 面板中修改完整通知配置，执行 `/config:notifications reset` 恢复默认值。面板里改动即时保存并生效，不需要 `/reload`。
Use `/config:notifications` to edit the complete notification configuration in the TUI panel, use `/config:notifications reset` for defaults. Panel changes are saved and applied immediately; no `/reload` is needed.
## 运行行为
- `ask_user_question` 和 `ask_user` 在真正等待输入前发送通知。
- `agent_end` 发送完成通知，并根据 tool result 是否报错选择完成或错误标题；消息包含 turn 数和耗时。
- 命令通过 argv 执行，不经过 shell；不要把整条 shell 命令写入 `adapter.args`。
- 扩展加载时不依赖外部命令存在；第一次发送通知时探测命令。
- 命令缺失或第一次执行失败只提示一次，并停用当前运行的外部通知；Pi 任务继续执行，不要重试或阻塞。
- 运行时文案语言由 `pi-extensions-i18n` 控制。
## 排查
1. 检查配置文件的 JSON、`enabled`、命令和 argv 参数类型。
2. 在当前 Pi 进程的 `PATH` 中确认配置的命令可执行。
3. 如果看到一次“命令不可用”或“执行失败”提示，先修复命令或配置，再执行 `/reload`。
4. 不要读取凭据、Pi settings 或私有服务来排查通知 adapter。
…Read the whole file at its exact version.
How to install
mdr add maplezzk/pi-extensions/configure-pi-notifications@sha256:2b7f24c463450d0eThe line at the top of this page pins the label git:20260922.e07845b, 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_jkginzlo7vsx7ojg)
5 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 4 versions of this file, between Sep 5, 2026 and Sep 22, 2026, about one every 6 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260922.e07845b latest | 2026-09-22 | e07845b | 2,670 B | A | view · diff |
| git:20260907.3bd68af | 2026-09-07 | 3bd68af | 2,531 B | A | view · diff |
| git:20260906.5bc2191 | 2026-09-06 | 5bc2191 | 2,636 B | A | view · diff |
| git:20260905.1bba7c7 | 2026-09-05 | 1bba7c7 | 2,252 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 (2670 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_jkginzlo7vsx7ojg GET https://markdownregistry.com/api/v1/resolve?ref=maplezzk/pi-extensions/configure-pi-notifications GET https://markdownregistry.com/api/v1/blob/2b7f24c463450d0e416963090e6c98a29a41210888a3e67b994ce766adf6977a
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.