@astralyn/pi 1.4.5 → 1.4.7

package/docs/skills.md

@@ -82,6 +82,29 @@ Skills register as `/skill:name` commands:
 
 Arguments after the command are appended to the skill content as `User: <args>`.
 
+### Invocation Policy
+
+Use `pi config` to cycle each skill through three states:
+
+- **On:** the skill is loaded, advertised to the model, and available as `/skill:name`.
+- **User only:** the skill is loaded and available as `/skill:name`, but omitted from the system prompt.
+- **Off:** the skill is not loaded.
+
+Project mode also supports inheriting the global state or explicitly overriding it. Without an override, `disable-model-invocation` in `SKILL.md` determines whether a loaded skill starts as On or User only.
+
+For settings-based configuration, keep using the `skills` array to control loading and add `skillInvocationOverrides` for invocation policy. Keys name exact skill files or directories, and values are `"model-and-user"` or `"user-only"`:
+
+```json
+{
+  "skillInvocationOverrides": {
+    "skills/pdf/SKILL.md": "user-only",
+    "skills/formatter": "model-and-user"
+  }
+}
+```
+
+Project overrides take precedence over global overrides. An explicit `"model-and-user"` also overrides author-level `disable-model-invocation`; removing the override restores the frontmatter default. Invocation overrides do not force a disabled skill to load.
+
 Toggle skill commands via `/settings` in interactive mode or in `settings.json`:
 
 ```json

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
 	"name": "@astralyn/pi",
-	"version": "1.4.5",
+	"version": "1.4.7",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "@astralyn/pi",
-			"version": "1.4.5",
+			"version": "1.4.7",
 			"license": "MIT",
 			"dependencies": {
 				"@earendil-works/pi-agent-core": "1.4.0",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@astralyn/pi",
-	"version": "1.4.5",
+	"version": "1.4.7",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"piConfig": {

package/schemas/settings.schema.json

@@ -338,6 +338,24 @@
                 "items": {
                   "type": "string"
                 }
+              },
+              "skillInvocationOverrides": {
+                "type": "object",
+                "patternProperties": {
+                  "^.*$": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "const": "model-and-user"
+                      },
+                      {
+                        "type": "string",
+                        "const": "user-only"
+                      }
+                    ]
+                  }
+                },
+                "description": "Per-skill invocation overrides, keyed by skill file or directory path."
               }
             }
           }
@@ -383,6 +401,24 @@
       ],
       "description": "Local skill file paths or directories."
     },
+    "skillInvocationOverrides": {
+      "type": "object",
+      "patternProperties": {
+        "^.*$": {
+          "anyOf": [
+            {
+              "type": "string",
+              "const": "model-and-user"
+            },
+            {
+              "type": "string",
+              "const": "user-only"
+            }
+          ]
+        }
+      },
+      "description": "Per-skill invocation overrides, keyed by skill file or directory path."
+    },
     "prompts": {
       "type": "array",
       "items": {