pi-skill-guard

Pi extension for protecting against incorrect skill-in-tool-call behavior

Package details

← Back
extension

Install pi-skill-guard from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:pi-skill-guard
Package
pi-skill-guard
Version
0.0.1
Published
Apr 30, 2026
Downloads
not available
Author
tychenjiajun
License
ISC
Types
extension
Size
6.1 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-skill-guard

一个用于防止错误的 skill-in-tool-call 行为的 pi 扩展。

安装

pi install npm:pi-skill-guard

功能说明

此扩展用于防止错误的 skill 调用模式。当 LLM 尝试调用一个与可用 skill 同名的工具时（例如，将 brave-search 作为工具调用，而不是使用 /skill:brave-search 或手动加载 skill），该扩展会拦截该调用并将其重定向到读取 skill 的 SKILL.md 文件。

工作原理

  1. 监听 tool_call 事件
  2. 检查工具名称是否匹配任何可用的 skill
  3. 如果匹配，自动将工具调用转换为 read 工具调用，加载 skill 的 SKILL.md 文件
  4. 通过 UI 通知用户该 skill 已被重定向

这确保即使模型错误地尝试将 skill 作为工具调用，仍能访问 skill 内容。

示例

如果模型错误地调用：

tool_call { toolName: "brave-search", input: {...} }

扩展将将其重定向为：

tool_call { toolName: "read", input: { path: "~/.pi/agent/skills/brave-search/SKILL.md" } }

使用场景

  • 防止模型在误解 skill 调用方式时失败
  • 确保无论模型如何尝试使用 skill，都可以访问 skill 内容
  • 透明工作，无需显式使用 /skill:name 命令