pi-better-skill-prompt 0.1.0 → 0.2.0

package/README.md

@@ -4,7 +4,7 @@
 
 A leaner skill prompt for [Pi](https://github.com/earendil-works/pi). Replaces nested XML skill entries with a Markdown table and adds `load_skill` for on-demand loading.
 
-- **Compact catalog:** only skill names and descriptions stay in the system prompt.
+- **Compact catalog:** a table of skill names and descriptions, with one loading hint.
 - **Progressive disclosure:** the model gets skill paths only when it loads a skill.
 - **No repeated metadata:** loading returns the skill directory and full body, without frontmatter containing the name and description.
 
@@ -41,6 +41,8 @@ After:
 ```text
 <available_skills>
 
+Load a skill by name with `load_skill` when its description matches the task.
+
 |name|description|
 |---|---|
 |code-review|Review changes for correctness.|

package/README.zh-CN.md

@@ -4,7 +4,7 @@
 
 让 [Pi](https://github.com/earendil-works/pi) 的技能提示词更精简：用 Markdown 表格替代嵌套 XML 技能条目，通过 `load_skill` 按需加载。
 
-- **精简目录**：常驻提示词只保留技能名称和描述。
+- **精简目录**：技能名称和描述组成表格，表格前只有一句加载提示。
 - **渐进式披露**：加载技能时才返回路径，不提前占用上下文。
 - **不重复元数据**：加载结果只有技能目录和完整正文，去掉包含名称、描述的 frontmatter。
 
@@ -41,6 +41,8 @@ Resolve relative paths against the skill's directory (parent of SKILL.md). Use a
 ```text
 <available_skills>
 
+Load a skill by name with `load_skill` when its description matches the task.
+
 |name|description|
 |---|---|
 |code-review|Review changes for correctness.|

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-better-skill-prompt",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "A Markdown skill catalog with on-demand loading for Pi.",
   "type": "module",
   "keywords": [

package/src/catalog.ts

@@ -7,5 +7,5 @@ function cell(text: string): string {
 /** Body of the `available_skills` prompt section; Pi wraps it in the section's tags. */
 export function renderCatalog(skills: readonly Skill[]): string {
   const rows = skills.map((skill) => `|${cell(skill.name)}|${cell(skill.description)}|`);
-  return ["", "|name|description|", "|---|---|", ...rows, ""].join("\n");
+  return ["", "Load a skill by name with `load_skill` when its description matches the task.", "", "|name|description|", "|---|---|", ...rows, ""].join("\n");
 }