skilld-sdk 0.1.2 → 0.2.0

package/dist/contract.d.mts

@@ -3742,6 +3742,25 @@ declare const skillDetailSchema: CompatibleSchema<z.ZodObject<{
   readonly generatedSummary: z.ZodNullable<z.ZodString>;
   /** The SKILL.md text the registry last read, frontmatter included. */
   readonly markdown: z.ZodNullable<z.ZodString>;
+  /**
+   * What the SKILL.md and the file names ask an Agent to do, matched by the
+   * fixed rules in `skilld-protocol/behaviors`. `skilld run` checks every file,
+   * so it can find more. A behavior with tier `ask` stops `skilld run` until the
+   * user approves it. An empty list never means the Skill does nothing.
+   */
+  readonly behaviors: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    tier: z.ZodEnum<{
+      ask: "ask";
+      show: "show";
+    }>;
+    label: z.ZodString;
+    locations: z.ZodArray<z.ZodObject<{
+      path: z.ZodString;
+      line: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>>;
+    total: z.ZodNumber;
+  }, z.core.$strict>>;
   readonly owner: z.ZodString;
   readonly repository: z.ZodString;
   readonly name: z.ZodString;
@@ -3779,6 +3798,25 @@ declare const skillDetailSchema: CompatibleSchema<z.ZodObject<{
   readonly generatedSummary: z.ZodNullable<z.ZodString>;
   /** The SKILL.md text the registry last read, frontmatter included. */
   readonly markdown: z.ZodNullable<z.ZodString>;
+  /**
+   * What the SKILL.md and the file names ask an Agent to do, matched by the
+   * fixed rules in `skilld-protocol/behaviors`. `skilld run` checks every file,
+   * so it can find more. A behavior with tier `ask` stops `skilld run` until the
+   * user approves it. An empty list never means the Skill does nothing.
+   */
+  readonly behaviors: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    tier: z.ZodEnum<{
+      ask: "ask";
+      show: "show";
+    }>;
+    label: z.ZodString;
+    locations: z.ZodArray<z.ZodObject<{
+      path: z.ZodString;
+      line: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>>;
+    total: z.ZodNumber;
+  }, z.core.$strict>>;
   readonly owner: z.ZodString;
   readonly repository: z.ZodString;
   readonly name: z.ZodString;
@@ -3953,6 +3991,25 @@ declare const skillsV1: SkilldV1Registry<{
         readonly generatedSummary: z.ZodNullable<z.ZodString>;
         /** The SKILL.md text the registry last read, frontmatter included. */
         readonly markdown: z.ZodNullable<z.ZodString>;
+        /**
+         * What the SKILL.md and the file names ask an Agent to do, matched by the
+         * fixed rules in `skilld-protocol/behaviors`. `skilld run` checks every file,
+         * so it can find more. A behavior with tier `ask` stops `skilld run` until the
+         * user approves it. An empty list never means the Skill does nothing.
+         */
+        readonly behaviors: z.ZodArray<z.ZodObject<{
+          id: z.ZodString;
+          tier: z.ZodEnum<{
+            ask: "ask";
+            show: "show";
+          }>;
+          label: z.ZodString;
+          locations: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            line: z.ZodNullable<z.ZodNumber>;
+          }, z.core.$strict>>;
+          total: z.ZodNumber;
+        }, z.core.$strict>>;
         readonly owner: z.ZodString;
         readonly repository: z.ZodString;
         readonly name: z.ZodString;
@@ -3990,6 +4047,25 @@ declare const skillsV1: SkilldV1Registry<{
         readonly generatedSummary: z.ZodNullable<z.ZodString>;
         /** The SKILL.md text the registry last read, frontmatter included. */
         readonly markdown: z.ZodNullable<z.ZodString>;
+        /**
+         * What the SKILL.md and the file names ask an Agent to do, matched by the
+         * fixed rules in `skilld-protocol/behaviors`. `skilld run` checks every file,
+         * so it can find more. A behavior with tier `ask` stops `skilld run` until the
+         * user approves it. An empty list never means the Skill does nothing.
+         */
+        readonly behaviors: z.ZodArray<z.ZodObject<{
+          id: z.ZodString;
+          tier: z.ZodEnum<{
+            ask: "ask";
+            show: "show";
+          }>;
+          label: z.ZodString;
+          locations: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            line: z.ZodNullable<z.ZodNumber>;
+          }, z.core.$strict>>;
+          total: z.ZodNumber;
+        }, z.core.$strict>>;
         readonly owner: z.ZodString;
         readonly repository: z.ZodString;
         readonly name: z.ZodString;
@@ -4010,7 +4086,7 @@ declare const skillsV1: SkilldV1Registry<{
     };
     readonly docs: {
       readonly summary: "Get a Skill";
-      readonly description: "One Skill with its provenance: the Owner, the exact SKILL.md, the commit the registry read, and the run and install commands.";
+      readonly description: "One Skill with its provenance: the Owner, the exact SKILL.md, the commit the registry read, and the run and install commands. `behaviors` lists what the SKILL.md and the file names ask an Agent to do. `skilld run` checks every file, so it can find more. A behavior with tier `ask` stops `skilld run` until the user approves it.";
       readonly tag: "Skills";
       readonly examples: readonly [{
         readonly request: {
@@ -4036,6 +4112,16 @@ declare const skillsV1: SkilldV1Registry<{
           }];
           readonly generatedSummary: "Checks interface code against a published list of web design rules.";
           readonly markdown: "---\nname: web-design-guidelines\ndescription: Review UI code for compliance with web interface guidelines.\n---\n\n# Web Design Guidelines\n";
+          readonly behaviors: readonly [{
+            readonly id: "shell";
+            readonly tier: "show";
+            readonly label: "Runs shell commands";
+            readonly locations: readonly [{
+              readonly path: "SKILL.md";
+              readonly line: 12;
+            }];
+            readonly total: 1;
+          }];
           readonly owner: "vercel-labs";
           readonly repository: "agent-skills";
           readonly name: "web-design-guidelines";
@@ -4272,6 +4358,19 @@ declare const skilldV1Protocol: {
             }, import("zod/v4/core").$strict>>;
             readonly generatedSummary: import("zod").ZodNullable<import("zod").ZodString>;
             readonly markdown: import("zod").ZodNullable<import("zod").ZodString>;
+            readonly behaviors: import("zod").ZodArray<import("zod").ZodObject<{
+              id: import("zod").ZodString;
+              tier: import("zod").ZodEnum<{
+                ask: "ask";
+                show: "show";
+              }>;
+              label: import("zod").ZodString;
+              locations: import("zod").ZodArray<import("zod").ZodObject<{
+                path: import("zod").ZodString;
+                line: import("zod").ZodNullable<import("zod").ZodNumber>;
+              }, import("zod/v4/core").$strict>>;
+              total: import("zod").ZodNumber;
+            }, import("zod/v4/core").$strict>>;
             readonly owner: import("zod").ZodString;
             readonly repository: import("zod").ZodString;
             readonly name: import("zod").ZodString;
@@ -4300,6 +4399,19 @@ declare const skilldV1Protocol: {
             }, import("zod/v4/core").$strict>>;
             readonly generatedSummary: import("zod").ZodNullable<import("zod").ZodString>;
             readonly markdown: import("zod").ZodNullable<import("zod").ZodString>;
+            readonly behaviors: import("zod").ZodArray<import("zod").ZodObject<{
+              id: import("zod").ZodString;
+              tier: import("zod").ZodEnum<{
+                ask: "ask";
+                show: "show";
+              }>;
+              label: import("zod").ZodString;
+              locations: import("zod").ZodArray<import("zod").ZodObject<{
+                path: import("zod").ZodString;
+                line: import("zod").ZodNullable<import("zod").ZodNumber>;
+              }, import("zod/v4/core").$strict>>;
+              total: import("zod").ZodNumber;
+            }, import("zod/v4/core").$strict>>;
             readonly owner: import("zod").ZodString;
             readonly repository: import("zod").ZodString;
             readonly name: import("zod").ZodString;
@@ -4320,7 +4432,7 @@ declare const skilldV1Protocol: {
         };
         readonly docs: {
           readonly summary: "Get a Skill";
-          readonly description: "One Skill with its provenance: the Owner, the exact SKILL.md, the commit the registry read, and the run and install commands.";
+          readonly description: "One Skill with its provenance: the Owner, the exact SKILL.md, the commit the registry read, and the run and install commands. `behaviors` lists what the SKILL.md and the file names ask an Agent to do. `skilld run` checks every file, so it can find more. A behavior with tier `ask` stops `skilld run` until the user approves it.";
           readonly tag: "Skills";
           readonly examples: readonly [{
             readonly request: {
@@ -4346,6 +4458,16 @@ declare const skilldV1Protocol: {
               }];
               readonly generatedSummary: "Checks interface code against a published list of web design rules.";
               readonly markdown: "---\nname: web-design-guidelines\ndescription: Review UI code for compliance with web interface guidelines.\n---\n\n# Web Design Guidelines\n";
+              readonly behaviors: readonly [{
+                readonly id: "shell";
+                readonly tier: "show";
+                readonly label: "Runs shell commands";
+                readonly locations: readonly [{
+                  readonly path: "SKILL.md";
+                  readonly line: 12;
+                }];
+                readonly total: 1;
+              }];
               readonly owner: "vercel-labs";
               readonly repository: "agent-skills";
               readonly name: "web-design-guidelines";

package/dist/contract.mjs

@@ -2246,7 +2246,23 @@ const skillDetailSchema = defineResponseObject({
 	/** Machine-generated from the SKILL.md. Never written by the author. */
 	generatedSummary: z.string().nullable(),
 	/** The SKILL.md text the registry last read, frontmatter included. */
-	markdown: z.string().nullable()
+	markdown: z.string().nullable(),
+	/**
+	* What the SKILL.md and the file names ask an Agent to do, matched by the
+	* fixed rules in `skilld-protocol/behaviors`. `skilld run` checks every file,
+	* so it can find more. A behavior with tier `ask` stops `skilld run` until the
+	* user approves it. An empty list never means the Skill does nothing.
+	*/
+	behaviors: z.array(z.strictObject({
+		id: z.string(),
+		tier: z.enum(["ask", "show"]),
+		label: z.string(),
+		locations: z.array(z.strictObject({
+			path: z.string(),
+			line: z.number().int().positive().nullable()
+		})).max(5),
+		total: countSchema
+	}))
 });
 /**
 * The skilld.dev/skills listing. Stars order it by default. Likes order it
@@ -2348,7 +2364,7 @@ const skillsV1 = defineRegistry({
 			lifecycle: { introduced: "1.0.0" },
 			docs: {
 				summary: "Get a Skill",
-				description: "One Skill with its provenance: the Owner, the exact SKILL.md, the commit the registry read, and the run and install commands.",
+				description: "One Skill with its provenance: the Owner, the exact SKILL.md, the commit the registry read, and the run and install commands. `behaviors` lists what the SKILL.md and the file names ask an Agent to do. `skilld run` checks every file, so it can find more. A behavior with tier `ask` stops `skilld run` until the user approves it.",
 				tag: "Skills",
 				examples: [{
 					request: { params: {
@@ -2372,7 +2388,17 @@ const skillsV1 = defineRegistry({
 							size: 4210
 						}],
 						generatedSummary: "Checks interface code against a published list of web design rules.",
-						markdown: "---\nname: web-design-guidelines\ndescription: Review UI code for compliance with web interface guidelines.\n---\n\n# Web Design Guidelines\n"
+						markdown: "---\nname: web-design-guidelines\ndescription: Review UI code for compliance with web interface guidelines.\n---\n\n# Web Design Guidelines\n",
+						behaviors: [{
+							id: "shell",
+							tier: "show",
+							label: "Runs shell commands",
+							locations: [{
+								path: "SKILL.md",
+								line: 12
+							}],
+							total: 1
+						}]
 					}
 				}]
 			}

package/generated/openapi.v1.json

@@ -2185,6 +2185,69 @@
               "null"
             ]
           },
+          "behaviors": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "label": {
+                  "type": "string"
+                },
+                "locations": {
+                  "items": {
+                    "additionalProperties": false,
+                    "properties": {
+                      "line": {
+                        "anyOf": [
+                          {
+                            "exclusiveMinimum": 0,
+                            "maximum": 9007199254740991,
+                            "type": "integer"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      },
+                      "path": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "path",
+                      "line"
+                    ],
+                    "type": "object"
+                  },
+                  "maxItems": 5,
+                  "type": "array"
+                },
+                "tier": {
+                  "enum": [
+                    "ask",
+                    "show"
+                  ],
+                  "type": "string"
+                },
+                "total": {
+                  "maximum": 9007199254740991,
+                  "minimum": 0,
+                  "type": "integer"
+                }
+              },
+              "required": [
+                "id",
+                "tier",
+                "label",
+                "locations",
+                "total"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
           "description": {
             "type": [
               "string",
@@ -2356,7 +2419,8 @@
           "allowedTools",
           "files",
           "generatedSummary",
-          "markdown"
+          "markdown",
+          "behaviors"
         ],
         "type": "object"
       },
@@ -10211,7 +10275,7 @@
     },
     "/api/v1/skills/{owner}/{repository}/{name}": {
       "get": {
-        "description": "One Skill with its provenance: the Owner, the exact SKILL.md, the commit the registry read, and the run and install commands.",
+        "description": "One Skill with its provenance: the Owner, the exact SKILL.md, the commit the registry read, and the run and install commands. `behaviors` lists what the SKILL.md and the file names ask an Agent to do. `skilld run` checks every file, so it can find more. A behavior with tier `ask` stops `skilld run` until the user approves it.",
         "operationId": "skills.get",
         "parameters": [
           {
@@ -10258,6 +10322,20 @@
                 "example": {
                   "allowedTools": [],
                   "authorName": "Vercel Labs",
+                  "behaviors": [
+                    {
+                      "id": "shell",
+                      "label": "Runs shell commands",
+                      "locations": [
+                        {
+                          "line": 12,
+                          "path": "SKILL.md"
+                        }
+                      ],
+                      "tier": "show",
+                      "total": 1
+                    }
+                  ],
                   "description": "Review UI code for compliance with web interface guidelines.",
                   "displayName": "Web Design Guidelines",
                   "files": [

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "skilld-sdk",
   "type": "module",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Typed client and OpenAPI contract for the skilld API.",
   "license": "MIT",
   "homepage": "https://skilld.dev/developers?setup=api",