skilld-sdk 0.1.1 → 0.2.0

package/dist/contract.d.mts

@@ -44,7 +44,7 @@ declare const SKILLD_V1_ERROR_TITLES: {
   readonly SERVICE_UNAVAILABLE: "Service unavailable";
 };
 /** Every operation can answer these, so no descriptor lists them. */
-declare const SKILLD_V1_IMPLICIT_ERRORS: readonly ["INTERNAL_ERROR", "SERVICE_UNAVAILABLE"];
+declare const SKILLD_V1_IMPLICIT_ERRORS: readonly ["RATE_LIMITED", "INTERNAL_ERROR", "SERVICE_UNAVAILABLE"];
 /** A retry can succeed for these codes, and for no others. */
 declare const SKILLD_V1_RETRYABLE_ERRORS: ReadonlySet<SkilldV1ErrorCode>;
 type SkilldV1Method = typeof SKILLD_V1_METHODS[number];
@@ -917,7 +917,7 @@ declare const likesV1: SkilldV1Registry<{
       readonly status: 204;
       readonly body: null;
     };
-    readonly errors: readonly ["INVALID_REQUEST", "AUTH_REQUIRED", "NOT_FOUND", "RATE_LIMITED"];
+    readonly errors: readonly ["INVALID_REQUEST", "AUTH_REQUIRED", "NOT_FOUND"];
     readonly lifecycle: {
       readonly introduced: "1.0.0";
     };
@@ -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";
@@ -6198,7 +6320,7 @@ declare const skilldV1Protocol: {
           readonly status: 204;
           readonly body: null;
         };
-        readonly errors: readonly ["INVALID_REQUEST", "AUTH_REQUIRED", "NOT_FOUND", "RATE_LIMITED"];
+        readonly errors: readonly ["INVALID_REQUEST", "AUTH_REQUIRED", "NOT_FOUND"];
         readonly lifecycle: {
           readonly introduced: "1.0.0";
         };

package/dist/contract.mjs

@@ -59,7 +59,11 @@ const SKILLD_V1_ERROR_TITLES = {
 	SERVICE_UNAVAILABLE: "Service unavailable"
 };
 /** Every operation can answer these, so no descriptor lists them. */
-const SKILLD_V1_IMPLICIT_ERRORS = ["INTERNAL_ERROR", "SERVICE_UNAVAILABLE"];
+const SKILLD_V1_IMPLICIT_ERRORS = [
+	"RATE_LIMITED",
+	"INTERNAL_ERROR",
+	"SERVICE_UNAVAILABLE"
+];
 /** A retry can succeed for these codes, and for no others. */
 const SKILLD_V1_RETRYABLE_ERRORS = /* @__PURE__ */ new Set(["RATE_LIMITED", "SERVICE_UNAVAILABLE"]);
 function pathParameterNames(path) {
@@ -697,8 +701,7 @@ const likesV1 = defineRegistry({
 			errors: [
 				"INVALID_REQUEST",
 				"AUTH_REQUIRED",
-				"NOT_FOUND",
-				"RATE_LIMITED"
+				"NOT_FOUND"
 			],
 			lifecycle: { introduced: "1.0.0" },
 			docs: {
@@ -2243,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
@@ -2345,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: {
@@ -2369,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
+						}]
 					}
 				}]
 			}