@hashicorp/kits 0.1.0

package/schemas/skill.schema.json

@@ -0,0 +1,96 @@
+{
+  "$schema": "https://json-schema.org/draft-07/schema#",
+  "$id": "https://hashicorp.com/schemas/skill.schema.json",
+  "title": "Skill Frontmatter",
+  "description": "Schema for skill primitive SKILL.md YAML frontmatter",
+  "type": "object",
+  "required": ["name", "description"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 50,
+      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+      "description": "Skill name in lowercase kebab-case (should match directory name)"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 10,
+      "maxLength": 200,
+      "description": "Description of the skill and when to use it"
+    },
+    "argumentHint": {
+      "type": "string",
+      "maxLength": 50,
+      "pattern": "^[<\\[][A-Z_]+[>\\]](\\s+[<\\[][A-Z_]+[>\\]])*$",
+      "description": "Hints shown during auto-complete to indicate expected arguments"
+    },
+    "disableModelInvocation": {
+      "type": "boolean",
+      "description": "Whether the model can invoke the skill autonomously"
+    },
+    "userInvocable": {
+      "type": "boolean",
+      "description": "Whether the user can invoke the skill"
+    },
+    "allowedTools": {
+      "description": "Tools the harness can use without asking permission while executing the skill. Supports tool templates.",
+      "anyOf": [
+        {
+          "type": "string",
+          "minLength": 1
+        },
+        {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 1
+        }
+      ]
+    },
+    "model": {
+      "type": "string",
+      "description": "Model used when this skill activates. Prefer canonical model templates like {{model:standard}}."
+    },
+    "context": {
+      "type": "string",
+      "description": "Whether to fork context and run as a subagent (e.g., 'fork')"
+    },
+    "agent": {
+      "type": "string",
+      "description": "Subagent to use when context: fork is set"
+    },
+    "hooks": {
+      "type": "array",
+      "description": "Canonical hook bindings scoped to the skill lifecycle",
+      "items": {
+        "type": "object",
+        "required": ["ref", "binding"],
+        "properties": {
+          "ref": {
+            "type": "string",
+            "minLength": 3,
+            "description": "Hook primitive reference (name@version-spec)"
+          },
+          "binding": {
+            "type": "object",
+            "description": "Hook binding definition",
+            "required": ["event"],
+            "properties": {
+              "event": {
+                "type": "string",
+                "enum": ["tool.before", "tool.after", "subagent.stop"],
+                "description": "Canonical skill hook event"
+              }
+            },
+            "additionalProperties": true
+          }
+        },
+        "additionalProperties": true
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/subagent.schema.json

@@ -0,0 +1,107 @@
+{
+  "$schema": "https://json-schema.org/draft-07/schema#",
+  "$id": "https://hashicorp.com/schemas/subagent.schema.json",
+  "title": "Subagent Frontmatter",
+  "description": "Schema for subagent primitive Markdown frontmatter",
+  "type": "object",
+  "required": ["name", "description"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 50,
+      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+      "description": "Subagent name in lowercase kebab-case"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 10,
+      "maxLength": 200,
+      "description": "Description of the subagent's expertise"
+    },
+    "allowedTools": {
+      "description": "Allowlist of tools the subagent can use. Supports tool templates.",
+      "anyOf": [
+        {
+          "type": "string",
+          "minLength": 1
+        },
+        {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 1
+        }
+      ]
+    },
+    "disallowedTools": {
+      "description": "Denylist of tools the subagent cannot use. Supports tool templates.",
+      "anyOf": [
+        {
+          "type": "string",
+          "minLength": 1
+        },
+        {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 1
+        }
+      ]
+    },
+    "model": {
+      "type": "string",
+      "description": "Model used when this subagent activates. Prefer canonical model templates like {{model:standard}}."
+    },
+    "maxTurns": {
+      "type": "number",
+      "description": "Maximum conversation turns"
+    },
+    "timeout": {
+      "type": "number",
+      "description": "Timeout in seconds"
+    },
+    "skills": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "description": "Skills to preload into the subagent's context"
+    },
+    "hooks": {
+      "type": "array",
+      "description": "Canonical hook bindings scoped to the subagent lifecycle",
+      "items": {
+        "type": "object",
+        "required": ["ref", "binding"],
+        "properties": {
+          "ref": {
+            "type": "string",
+            "minLength": 3,
+            "description": "Hook primitive reference (name@version-spec)"
+          },
+          "binding": {
+            "type": "object",
+            "description": "Hook binding definition",
+            "required": ["event"],
+            "properties": {
+              "event": {
+                "type": "string",
+                "enum": ["tool.before", "tool.after", "subagent.stop"],
+                "description": "Canonical subagent hook event"
+              }
+            },
+            "additionalProperties": true
+          }
+        },
+        "additionalProperties": true
+      }
+    }
+  },
+  "additionalProperties": false
+}