@agentproto/skill 0.2.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 agentproto contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,23 @@
+# @agentproto/skill
+
+AIP-3 `SKILL.md` reference implementation. A markdown + frontmatter format for distributing reusable agent skills as portable, version-controlled files.
+
+> **Status: 0.1.0-alpha.** Generated by `scripts/scaffold-aip.mjs` — `build()` and `validate()` bodies are TODOs.
+
+Spec: <https://agentproto.sh/docs/aip-3>
+
+## Usage
+
+```ts
+import { defineSkill } from "@agentproto/skill"
+
+const x = defineSkill({
+  id: "my-skill",
+  description: "Short purpose.",
+  // ...
+})
+```
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/chunk-GZK4KIZA.mjs

@@ -0,0 +1,113 @@
+import { z } from 'zod';
+import { createDoctype } from '@agentproto/define-doctype';
+
+/**
+ * @agentproto/skill v0.1.0-alpha
+ * AIP-3 SKILL.md `defineSkill` reference implementation.
+ */
+
+var NAME_PATTERN = /^[a-z0-9](?:[a-z0-9]|-(?!-))*[a-z0-9]$|^[a-z0-9]$/;
+var SEMVER_PATTERN = /^\d+\.\d+\.\d+(?:[-+][a-zA-Z0-9.-]+)?$/;
+var TAG_PATTERN = /^[a-z][a-z0-9-]*$/;
+var executionSchema = z.object({
+  language: z.enum(["typescript", "javascript", "python", "shell"]).describe("Implementation language. Runtimes MAY refuse languages they don't support."),
+  code: z.union([
+    z.object({
+      file: z.string().min(1).describe(
+        "Relative path to the entry file. SHOULD live under `scripts/`. Path traversal segments escaping the skill dir MUST be rejected."
+      )
+    }).strict(),
+    z.object({
+      inline: z.string().describe("Inline source. Runtimes MUST sandbox before executing.")
+    }).strict()
+  ]).describe("Exactly one of { file } or { inline }. File paths are relative to SKILL.md."),
+  entrypoint: z.string().min(1).optional(),
+  runtime: z.object({
+    provider: z.string().optional(),
+    timeout: z.number().int().positive().optional(),
+    memory: z.string().optional()
+  }).strict().optional(),
+  artifacts: z.object({
+    patterns: z.array(z.string()).min(1)
+  }).strict().optional(),
+  dependencies: z.record(z.string(), z.string()).optional()
+}).strict().describe("Executable bindings. Required when variant=executable.");
+var aip3ExtensionsSchema = z.object({
+  schema: z.literal("skills/v1").describe("Schema dispatch tag. Required for AIP-3 conformance."),
+  variant: z.enum(["instruction", "executable", "composite"]).default("instruction").describe(
+    "Skill variant. `instruction` is prose-only (default); `executable` bundles runnable code via `execution`; `composite` references other skills via `uses`."
+  ),
+  version: z.string().regex(SEMVER_PATTERN).optional().describe("Semver. Bump on breaking changes to the skill's behavior or required tools."),
+  tags: z.array(z.string().regex(TAG_PATTERN)).max(12).default([]).describe("Catalog tags. Lowercase kebab-case; no leading symbols. 3\u20136 tags is typical."),
+  category: z.string().min(1).max(64).optional().describe(
+    "Coarse grouping (e.g. 'productivity', 'creative', 'development'). Free-form; runtimes SHOULD NOT enumerate."
+  ),
+  requires: z.array(z.number().int().positive()).default([]).describe(
+    "Other AIPs this skill depends on (e.g. `[9]` for the operator runtime). Runtimes MAY warn when a declared dependency is unsupported."
+  ),
+  author: z.string().max(200).optional().describe(
+    "Optional. Conventional shape: 'Name <email>' or stable handle. Mirrors agentskills.io's `metadata.author` convention; if both are present, `metadata.aip3.author` wins for AIP-3 runtimes."
+  ),
+  title: z.string().min(1).max(120).optional().describe(
+    "Optional human-readable display title. Headless runtimes that can't render the body H1 MAY use this. The body H1 is preferred."
+  ),
+  uses: z.array(z.string().regex(NAME_PATTERN)).default([]).describe(
+    "Skill names this skill composes with. Required and non-empty when variant=composite."
+  ),
+  execution: executionSchema.optional()
+}).loose();
+var skillFrontmatterSchema = z.object({
+  name: z.string().min(1).max(64).regex(NAME_PATTERN).describe(
+    "Machine identifier. 1\u201364 chars, lowercase alphanumeric and hyphens only, no leading/trailing/consecutive hyphens. MUST equal the parent directory name. Inherited verbatim from agentskills.io."
+  ),
+  description: z.string().min(1).max(1024).describe(
+    "One-paragraph purpose. SHOULD describe both what the skill does and when to use it. Inherited from agentskills.io (1024-char cap)."
+  ),
+  license: z.string().max(200).optional().describe(
+    "Optional. License identifier (SPDX or pointer to a bundled license file). Inherited from agentskills.io."
+  ),
+  compatibility: z.string().min(1).max(500).optional().describe(
+    "Optional. Free-form environment requirements: intended product, system packages, network access, etc. Most skills omit this."
+  ),
+  "allowed-tools": z.string().optional().describe(
+    "Optional. Space-separated list of pre-approved tool patterns (e.g. 'Bash(git:*) Read'). Experimental upstream \u2014 runtimes MAY ignore. The field is a request, not a grant."
+  ),
+  metadata: z.object({ aip3: aip3ExtensionsSchema.optional() }).loose().default({}).describe(
+    "Free-form key-value mapping. Hosts and standards stash extension fields under namespaced keys (e.g. `metadata.aip3.*`, `metadata.acme.*`). Inherited from agentskills.io."
+  )
+}).loose().describe(
+  "Validates the YAML frontmatter portion of an AIP-3 SKILL.md manifest. AIP-3 is a profile of agentskills.io."
+);
+var defineSkill = createDoctype({
+  aip: 3,
+  name: "skill",
+  readIdentity: (def) => def.name,
+  validate(def) {
+    const result = skillFrontmatterSchema.safeParse(def);
+    if (!result.success) {
+      throw new Error(
+        `defineSkill (AIP-3): ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`
+      );
+    }
+    const aip3 = result.data.metadata?.aip3;
+    if (!aip3) return;
+    const variant = aip3.variant ?? "instruction";
+    if (variant === "executable" && !aip3.execution) {
+      throw new Error(
+        "defineSkill (AIP-3): metadata.aip3.execution is required when metadata.aip3.variant=executable"
+      );
+    }
+    if (variant === "composite" && (!aip3.uses || aip3.uses.length === 0)) {
+      throw new Error(
+        "defineSkill (AIP-3): metadata.aip3.uses must be non-empty when metadata.aip3.variant=composite"
+      );
+    }
+  },
+  build(def) {
+    return { ...def };
+  }
+});
+
+export { aip3ExtensionsSchema, defineSkill, skillFrontmatterSchema };
+//# sourceMappingURL=chunk-GZK4KIZA.mjs.map
+//# sourceMappingURL=chunk-GZK4KIZA.mjs.map

package/dist/chunk-GZK4KIZA.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema.ts","../src/define-skill.ts"],"names":[],"mappings":"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","file":"chunk-GZK4KIZA.mjs","sourcesContent":["/**\n * AIP-3 SKILL.md frontmatter zod schema.\n *\n * Mirrors `resources/aip-3/draft/SKILL.schema.json` field-for-field.\n * AIP-3 is a profile of agentskills.io — top-level fields are the\n * canonical agentskills.io frontmatter; AIP-3 extensions live under\n * `metadata.aip3.*` so a skill authored against AIP-3 remains a valid\n * agentskills.io skill in any conformant runtime.\n *\n * Both authoring paths (`define-skill.ts` for TS-authored skills and\n * `manifest/index.ts` for SKILL.md parsing) validate against this\n * schema, so every field-level constraint runs in both paths from a\n * single source of truth.\n *\n * Cross-field rules (variant=executable ⇒ execution required;\n * variant=composite ⇒ uses non-empty) live in `define-skill.ts`'s\n * `validate(def)` body — they're harder to encode in a flat zod\n * schema and want a single error path.\n */\n\nimport { z } from \"zod\"\n\n/** agentskills.io `name` rule: 1–64, kebab, no leading/trailing/consecutive `-`. */\nconst NAME_PATTERN = /^[a-z0-9](?:[a-z0-9]|-(?!-))*[a-z0-9]$|^[a-z0-9]$/\n\nconst SEMVER_PATTERN = /^\\d+\\.\\d+\\.\\d+(?:[-+][a-zA-Z0-9.-]+)?$/\nconst TAG_PATTERN = /^[a-z][a-z0-9-]*$/\n\nconst executionSchema = z\n  .object({\n    language: z\n      .enum([\"typescript\", \"javascript\", \"python\", \"shell\"])\n      .describe(\"Implementation language. Runtimes MAY refuse languages they don't support.\"),\n    code: z\n      .union([\n        z\n          .object({\n            file: z\n              .string()\n              .min(1)\n              .describe(\n                \"Relative path to the entry file. SHOULD live under `scripts/`. Path traversal segments escaping the skill dir MUST be rejected.\",\n              ),\n          })\n          .strict(),\n        z\n          .object({\n            inline: z\n              .string()\n              .describe(\"Inline source. Runtimes MUST sandbox before executing.\"),\n          })\n          .strict(),\n      ])\n      .describe(\"Exactly one of { file } or { inline }. File paths are relative to SKILL.md.\"),\n    entrypoint: z.string().min(1).optional(),\n    runtime: z\n      .object({\n        provider: z.string().optional(),\n        timeout: z.number().int().positive().optional(),\n        memory: z.string().optional(),\n      })\n      .strict()\n      .optional(),\n    artifacts: z\n      .object({\n        patterns: z.array(z.string()).min(1),\n      })\n      .strict()\n      .optional(),\n    dependencies: z.record(z.string(), z.string()).optional(),\n  })\n  .strict()\n  .describe(\"Executable bindings. Required when variant=executable.\")\n\nexport const aip3ExtensionsSchema = z\n  .object({\n    schema: z\n      .literal(\"skills/v1\")\n      .describe(\"Schema dispatch tag. Required for AIP-3 conformance.\"),\n    variant: z\n      .enum([\"instruction\", \"executable\", \"composite\"])\n      .default(\"instruction\")\n      .describe(\n        \"Skill variant. `instruction` is prose-only (default); `executable` bundles runnable code via `execution`; `composite` references other skills via `uses`.\",\n      ),\n    version: z\n      .string()\n      .regex(SEMVER_PATTERN)\n      .optional()\n      .describe(\"Semver. Bump on breaking changes to the skill's behavior or required tools.\"),\n    tags: z\n      .array(z.string().regex(TAG_PATTERN))\n      .max(12)\n      .default([])\n      .describe(\"Catalog tags. Lowercase kebab-case; no leading symbols. 3–6 tags is typical.\"),\n    category: z\n      .string()\n      .min(1)\n      .max(64)\n      .optional()\n      .describe(\n        \"Coarse grouping (e.g. 'productivity', 'creative', 'development'). Free-form; runtimes SHOULD NOT enumerate.\",\n      ),\n    requires: z\n      .array(z.number().int().positive())\n      .default([])\n      .describe(\n        \"Other AIPs this skill depends on (e.g. `[9]` for the operator runtime). Runtimes MAY warn when a declared dependency is unsupported.\",\n      ),\n    author: z\n      .string()\n      .max(200)\n      .optional()\n      .describe(\n        \"Optional. Conventional shape: 'Name <email>' or stable handle. Mirrors agentskills.io's `metadata.author` convention; if both are present, `metadata.aip3.author` wins for AIP-3 runtimes.\",\n      ),\n    title: z\n      .string()\n      .min(1)\n      .max(120)\n      .optional()\n      .describe(\n        \"Optional human-readable display title. Headless runtimes that can't render the body H1 MAY use this. The body H1 is preferred.\",\n      ),\n    uses: z\n      .array(z.string().regex(NAME_PATTERN))\n      .default([])\n      .describe(\n        \"Skill names this skill composes with. Required and non-empty when variant=composite.\",\n      ),\n    execution: executionSchema.optional(),\n  })\n  .loose()\n\nexport const skillFrontmatterSchema = z\n  .object({\n    name: z\n      .string()\n      .min(1)\n      .max(64)\n      .regex(NAME_PATTERN)\n      .describe(\n        \"Machine identifier. 1–64 chars, lowercase alphanumeric and hyphens only, no leading/trailing/consecutive hyphens. MUST equal the parent directory name. Inherited verbatim from agentskills.io.\",\n      ),\n    description: z\n      .string()\n      .min(1)\n      .max(1024)\n      .describe(\n        \"One-paragraph purpose. SHOULD describe both what the skill does and when to use it. Inherited from agentskills.io (1024-char cap).\",\n      ),\n    license: z\n      .string()\n      .max(200)\n      .optional()\n      .describe(\n        \"Optional. License identifier (SPDX or pointer to a bundled license file). Inherited from agentskills.io.\",\n      ),\n    compatibility: z\n      .string()\n      .min(1)\n      .max(500)\n      .optional()\n      .describe(\n        \"Optional. Free-form environment requirements: intended product, system packages, network access, etc. Most skills omit this.\",\n      ),\n    \"allowed-tools\": z\n      .string()\n      .optional()\n      .describe(\n        \"Optional. Space-separated list of pre-approved tool patterns (e.g. 'Bash(git:*) Read'). Experimental upstream — runtimes MAY ignore. The field is a request, not a grant.\",\n      ),\n    metadata: z\n      .object({ aip3: aip3ExtensionsSchema.optional() })\n      .loose()\n      .default({})\n      .describe(\n        \"Free-form key-value mapping. Hosts and standards stash extension fields under namespaced keys (e.g. `metadata.aip3.*`, `metadata.acme.*`). Inherited from agentskills.io.\",\n      ),\n  })\n  .loose()\n  .describe(\n    \"Validates the YAML frontmatter portion of an AIP-3 SKILL.md manifest. AIP-3 is a profile of agentskills.io.\",\n  )\n\nexport type SkillFrontmatter = z.infer<typeof skillFrontmatterSchema>\nexport type Aip3Extensions = z.infer<typeof aip3ExtensionsSchema>\n","import { createDoctype } from \"@agentproto/define-doctype\"\nimport { skillFrontmatterSchema } from \"./schema.js\"\nimport type { SkillDefinition, SkillHandle } from \"./types.js\"\n\n/**\n * AIP-3 reference implementation of `defineSkill`.\n *\n * Built on `createDoctype` so the cross-AIP invariants (id pattern,\n * description length, top-level freeze, \"defineSkill (AIP-3): …\"\n * error prefix) run uniformly with every other AIP defineX.\n *\n * Field-level validation runs the schema-derived zod from\n * `./schema.ts` against the input. Same source of truth as the .md\n * path uses (`parseSkillManifest`), so a malformed TS-authored\n * definition fails with the same diagnostic as a malformed manifest.\n *\n * Cross-field rules — variant=executable requires `metadata.aip3.execution`;\n * variant=composite requires non-empty `metadata.aip3.uses` — run after\n * the zod check so callers see one consistent error path.\n *\n * Identity / description extractors detected from the JSON Schema:\n *   readIdentity: def.name\n *   readDescription: def.description.\n */\nexport const defineSkill = createDoctype<SkillDefinition, SkillHandle>({\n  aip: 3,\n  name: \"skill\",\n  readIdentity: (def) => def.name,\n  validate(def) {\n    const result = skillFrontmatterSchema.safeParse(def)\n    if (!result.success) {\n      throw new Error(\n        `defineSkill (AIP-3): ${result.error.issues\n          .map((i) => `${i.path.join(\".\")}: ${i.message}`)\n          .join(\"; \")}`,\n      )\n    }\n\n    const aip3 = result.data.metadata?.aip3\n    if (!aip3) return\n\n    const variant = aip3.variant ?? \"instruction\"\n    if (variant === \"executable\" && !aip3.execution) {\n      throw new Error(\n        \"defineSkill (AIP-3): metadata.aip3.execution is required when metadata.aip3.variant=executable\",\n      )\n    }\n    if (variant === \"composite\" && (!aip3.uses || aip3.uses.length === 0)) {\n      throw new Error(\n        \"defineSkill (AIP-3): metadata.aip3.uses must be non-empty when metadata.aip3.variant=composite\",\n      )\n    }\n  },\n  build(def) {\n    return { ...def } as SkillHandle\n  },\n})\n"]}

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+import { S as SkillDefinition } from './schema-yW7X0mwK.js';
+export { A as Aip3Extensions, a as SkillExecution, b as SkillExecutionLanguage, c as SkillFrontmatter, d as SkillHandle, e as SkillVariant, f as aip3ExtensionsSchema, s as skillFrontmatterSchema } from './schema-yW7X0mwK.js';
+import 'zod';
+
+/**
+ * AIP-3 reference implementation of `defineSkill`.
+ *
+ * Built on `createDoctype` so the cross-AIP invariants (id pattern,
+ * description length, top-level freeze, "defineSkill (AIP-3): …"
+ * error prefix) run uniformly with every other AIP defineX.
+ *
+ * Field-level validation runs the schema-derived zod from
+ * `./schema.ts` against the input. Same source of truth as the .md
+ * path uses (`parseSkillManifest`), so a malformed TS-authored
+ * definition fails with the same diagnostic as a malformed manifest.
+ *
+ * Cross-field rules — variant=executable requires `metadata.aip3.execution`;
+ * variant=composite requires non-empty `metadata.aip3.uses` — run after
+ * the zod check so callers see one consistent error path.
+ *
+ * Identity / description extractors detected from the JSON Schema:
+ *   readIdentity: def.name
+ *   readDescription: def.description.
+ */
+declare const defineSkill: (def: SkillDefinition) => Readonly<SkillDefinition>;
+
+/**
+ * @agentproto/skill — AIP-3 SKILL.md `defineSkill` reference impl.
+ *
+ * A markdown + frontmatter format for distributing reusable agent skills as portable, version-controlled files.
+ *
+ * Spec: https://agentproto.sh/docs/aip-3
+ *
+ * Authoring paths:
+ *   - TS:  `defineSkill({...})` → `SkillHandle`
+ *   - MD:  `parseSkillManifest(src) → skillFromManifest({...})` → `SkillHandle`
+ */
+declare const SPEC_NAME: "agentskill/v1";
+declare const SPEC_VERSION: "2.0.0-alpha";
+
+export { SPEC_NAME, SPEC_VERSION, SkillDefinition, defineSkill };

package/dist/index.mjs

@@ -0,0 +1,14 @@
+export { aip3ExtensionsSchema, defineSkill, skillFrontmatterSchema } from './chunk-GZK4KIZA.mjs';
+
+/**
+ * @agentproto/skill v0.1.0-alpha
+ * AIP-3 SKILL.md `defineSkill` reference implementation.
+ */
+
+// src/index.ts
+var SPEC_NAME = "agentskill/v1";
+var SPEC_VERSION = "2.0.0-alpha";
+
+export { SPEC_NAME, SPEC_VERSION };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;AAYO,IAAM,SAAA,GAAY;AAClB,IAAM,YAAA,GAAe","file":"index.mjs","sourcesContent":["/**\n * @agentproto/skill — AIP-3 SKILL.md `defineSkill` reference impl.\n *\n * A markdown + frontmatter format for distributing reusable agent skills as portable, version-controlled files.\n *\n * Spec: https://agentproto.sh/docs/aip-3\n *\n * Authoring paths:\n *   - TS:  `defineSkill({...})` → `SkillHandle`\n *   - MD:  `parseSkillManifest(src) → skillFromManifest({...})` → `SkillHandle`\n */\n\nexport const SPEC_NAME = \"agentskill/v1\" as const\nexport const SPEC_VERSION = \"2.0.0-alpha\" as const\n\nexport { defineSkill } from \"./define-skill.js\"\nexport { skillFrontmatterSchema, aip3ExtensionsSchema } from \"./schema.js\"\nexport type { SkillFrontmatter, Aip3Extensions } from \"./schema.js\"\nexport type {\n  SkillDefinition,\n  SkillHandle,\n  SkillVariant,\n  SkillExecution,\n  SkillExecutionLanguage,\n} from \"./types.js\"\n"]}

package/dist/manifest/index.d.ts

@@ -0,0 +1,28 @@
+import { c as SkillFrontmatter, d as SkillHandle } from '../schema-yW7X0mwK.js';
+export { s as skillFrontmatterSchema } from '../schema-yW7X0mwK.js';
+import 'zod';
+
+/**
+ * AIP-3 SKILL.md sidecar parser + manifest-to-handle constructor.
+ *
+ * Mirror of `@agentproto/tool/manifest` and `@agentproto/driver/manifest`:
+ * the .md provides metadata; the TS module supplies any spec-specific
+ * runtime bits (schemas, execute bodies, …) that can't live in
+ * frontmatter. Both inputs end up in `defineSkill` so the cross-AIP
+ * invariants run uniformly.
+ *
+ *
+ * The frontmatter zod schema below was generated from
+ * `resources/aip-3/draft/SKILL.schema.json` via json-schema-to-zod.
+ * Re-run scaffold-aip to refresh after spec changes (or hand-tune
+ * any constraint the converter doesn't capture cleanly).
+ */
+
+interface SkillManifest {
+    frontmatter: SkillFrontmatter;
+    body: string;
+}
+declare function parseSkillManifest(source: string): SkillManifest;
+declare function skillFromManifest(manifest: SkillManifest): SkillHandle;
+
+export { SkillFrontmatter, type SkillManifest, parseSkillManifest, skillFromManifest };

package/dist/manifest/index.mjs

@@ -0,0 +1,28 @@
+import { skillFrontmatterSchema, defineSkill } from '../chunk-GZK4KIZA.mjs';
+export { skillFrontmatterSchema } from '../chunk-GZK4KIZA.mjs';
+import matter from 'gray-matter';
+
+/**
+ * @agentproto/skill v0.1.0-alpha
+ * AIP-3 SKILL.md `defineSkill` reference implementation.
+ */
+function parseSkillManifest(source) {
+  const parsed = matter(source);
+  if (Object.keys(parsed.data).length === 0) {
+    throw new Error("parseSkillManifest: missing or empty frontmatter");
+  }
+  const result = skillFrontmatterSchema.safeParse(parsed.data);
+  if (!result.success) {
+    throw new Error(
+      `parseSkillManifest: invalid frontmatter \u2014 ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`
+    );
+  }
+  return { frontmatter: result.data, body: parsed.content };
+}
+function skillFromManifest(manifest) {
+  return defineSkill(manifest.frontmatter);
+}
+
+export { parseSkillManifest, skillFromManifest };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/manifest/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/manifest/index.ts"],"names":[],"mappings":";;;;;;;;AA8BO,SAAS,mBAAmB,MAAA,EAA+B;AAChE,EAAA,MAAM,MAAA,GAAS,OAAO,MAAM,CAAA;AAC5B,EAAA,IAAI,OAAO,IAAA,CAAK,MAAA,CAAO,IAAI,CAAA,CAAE,WAAW,CAAA,EAAG;AACzC,IAAA,MAAM,IAAI,MAAM,kDAAkD,CAAA;AAAA,EACpE;AACA,EAAA,MAAM,MAAA,GAAS,sBAAA,CAAuB,SAAA,CAAU,MAAA,CAAO,IAAI,CAAA;AAC3D,EAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,+CAAA,EAA6C,OAAO,KAAA,CAAM,MAAA,CACvD,IAAI,CAAC,CAAA,KAAM,GAAG,CAAA,CAAE,IAAA,CAAK,KAAK,GAAG,CAAC,KAAK,CAAA,CAAE,OAAO,EAAE,CAAA,CAC9C,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,KACf;AAAA,EACF;AACA,EAAA,OAAO,EAAE,WAAA,EAAa,MAAA,CAAO,IAAA,EAAM,IAAA,EAAM,OAAO,OAAA,EAAQ;AAC1D;AAEO,SAAS,kBAAkB,QAAA,EAAsC;AAKtE,EAAA,OAAO,WAAA,CAAY,SAAS,WAAyC,CAAA;AACvE","file":"index.mjs","sourcesContent":["/**\n * AIP-3 SKILL.md sidecar parser + manifest-to-handle constructor.\n *\n * Mirror of `@agentproto/tool/manifest` and `@agentproto/driver/manifest`:\n * the .md provides metadata; the TS module supplies any spec-specific\n * runtime bits (schemas, execute bodies, …) that can't live in\n * frontmatter. Both inputs end up in `defineSkill` so the cross-AIP\n * invariants run uniformly.\n *\n *\n * The frontmatter zod schema below was generated from\n * `resources/aip-3/draft/SKILL.schema.json` via json-schema-to-zod.\n * Re-run scaffold-aip to refresh after spec changes (or hand-tune\n * any constraint the converter doesn't capture cleanly).\n */\n\nimport matter from \"gray-matter\"\nimport { skillFrontmatterSchema, type SkillFrontmatter } from \"../schema.js\"\nimport { defineSkill } from \"../define-skill.js\"\nimport type { SkillDefinition, SkillHandle } from \"../types.js\"\n\n// Re-export so consumers can import the schema + inferred type either\n// from \"@@agentproto/skill/manifest\" or directly from \"@@agentproto/skill/schema\".\nexport { skillFrontmatterSchema, type SkillFrontmatter }\n\nexport interface SkillManifest {\n  frontmatter: SkillFrontmatter\n  body: string\n}\n\nexport function parseSkillManifest(source: string): SkillManifest {\n  const parsed = matter(source)\n  if (Object.keys(parsed.data).length === 0) {\n    throw new Error(\"parseSkillManifest: missing or empty frontmatter\")\n  }\n  const result = skillFrontmatterSchema.safeParse(parsed.data)\n  if (!result.success) {\n    throw new Error(\n      `parseSkillManifest: invalid frontmatter — ${result.error.issues\n        .map((i) => `${i.path.join(\".\")}: ${i.message}`)\n        .join(\"; \")}`,\n    )\n  }\n  return { frontmatter: result.data, body: parsed.content }\n}\n\nexport function skillFromManifest(manifest: SkillManifest): SkillHandle {\n  // The zod-validated frontmatter is structurally compatible with\n  // SkillDefinition; the cast pins the typing once the manifest\n  // schema and the TS interface diverge (e.g. handle has frozen fields\n  // a literal config doesn't carry yet).\n  return defineSkill(manifest.frontmatter as unknown as SkillDefinition)\n}\n"]}

package/dist/schema-yW7X0mwK.d.ts

@@ -0,0 +1,200 @@
+import { z } from 'zod';
+
+/**
+ * AIP-3 SkillDefinition + SkillHandle.
+ *
+ * Mirrors `resources/aip-3/draft/SKILL.schema.json`. AIP-3 is a profile
+ * of agentskills.io: top-level fields are the canonical agentskills.io
+ * frontmatter; AIP-3 extensions live under `metadata.aip3.*`.
+ *
+ * `SkillHandle` is the readonly view of the same shape; tighten it by
+ * hand for fields that get defaults applied in build().
+ */
+type SkillVariant = "instruction" | "executable" | "composite";
+type SkillExecutionLanguage = "typescript" | "javascript" | "python" | "shell";
+interface SkillExecution {
+    /** Implementation language. */
+    language: SkillExecutionLanguage;
+    /** Exactly one of { file } or { inline }. */
+    code: {
+        file: string;
+    } | {
+        inline: string;
+    };
+    /** Optional function name within the entry file. */
+    entrypoint?: string;
+    /** Optional runtime hints (provider, timeout, memory). */
+    runtime?: {
+        provider?: string;
+        timeout?: number;
+        memory?: string;
+    };
+    /** Glob patterns of output files the runtime should capture. */
+    artifacts?: {
+        patterns: string[];
+    };
+    /** Package -> version map. */
+    dependencies?: Record<string, string>;
+}
+/** AIP-3 extensions to the agentskills.io baseline. Lives under `metadata.aip3`. */
+interface Aip3Extensions$1 {
+    /** Schema dispatch tag. Required for AIP-3 conformance. */
+    schema: "skills/v1";
+    /** Skill variant. Defaults to "instruction" when omitted. */
+    variant?: SkillVariant;
+    /** Semver. */
+    version?: string;
+    /** Catalog tags. Lowercase kebab-case. */
+    tags?: string[];
+    /** Coarse grouping. Free-form. */
+    category?: string;
+    /** Other AIPs this skill depends on (e.g. [9] for the operator runtime). */
+    requires?: number[];
+    /** Author identifier. */
+    author?: string;
+    /** Optional human-readable display title (body H1 preferred). */
+    title?: string;
+    /** Skill names this skill composes with. Non-empty when variant=composite. */
+    uses?: string[];
+    /** Executable bindings. Required when variant=executable. */
+    execution?: SkillExecution;
+    /** AIP-3 extensions stay open: vendors MAY add namespaced sub-keys. */
+    [extension: string]: unknown;
+}
+/**
+ * AIP-3 SKILL.md frontmatter. The top-level fields mirror
+ * agentskills.io 1:1 so AIP-3 skills are valid agentskills.io skills.
+ */
+interface SkillDefinition {
+    /** Machine identifier — kebab, 1–64 chars, matches parent dir. */
+    name: string;
+    /** One-paragraph purpose, written for the LLM caller. ≤1024 chars. */
+    description: string;
+    /** Optional license identifier or pointer to a bundled license file. */
+    license?: string;
+    /** Optional environment requirements. */
+    compatibility?: string;
+    /** Optional space-separated tool allowlist. Request, not grant. */
+    "allowed-tools"?: string;
+    /**
+     * Free-form key-value map. Houses AIP-3 extensions at
+     * `metadata.aip3` and any vendor-namespaced extras.
+     */
+    metadata?: {
+        aip3?: Aip3Extensions$1;
+        [vendor: string]: unknown;
+    };
+    /** Top-level extension surface preserved for forward compatibility. */
+    [extension: string]: unknown;
+}
+type SkillHandle = Readonly<SkillDefinition>;
+
+/**
+ * AIP-3 SKILL.md frontmatter zod schema.
+ *
+ * Mirrors `resources/aip-3/draft/SKILL.schema.json` field-for-field.
+ * AIP-3 is a profile of agentskills.io — top-level fields are the
+ * canonical agentskills.io frontmatter; AIP-3 extensions live under
+ * `metadata.aip3.*` so a skill authored against AIP-3 remains a valid
+ * agentskills.io skill in any conformant runtime.
+ *
+ * Both authoring paths (`define-skill.ts` for TS-authored skills and
+ * `manifest/index.ts` for SKILL.md parsing) validate against this
+ * schema, so every field-level constraint runs in both paths from a
+ * single source of truth.
+ *
+ * Cross-field rules (variant=executable ⇒ execution required;
+ * variant=composite ⇒ uses non-empty) live in `define-skill.ts`'s
+ * `validate(def)` body — they're harder to encode in a flat zod
+ * schema and want a single error path.
+ */
+
+declare const aip3ExtensionsSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"skills/v1">;
+    variant: z.ZodDefault<z.ZodEnum<{
+        instruction: "instruction";
+        executable: "executable";
+        composite: "composite";
+    }>>;
+    version: z.ZodOptional<z.ZodString>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    category: z.ZodOptional<z.ZodString>;
+    requires: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+    author: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    uses: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    execution: z.ZodOptional<z.ZodObject<{
+        language: z.ZodEnum<{
+            typescript: "typescript";
+            javascript: "javascript";
+            python: "python";
+            shell: "shell";
+        }>;
+        code: z.ZodUnion<readonly [z.ZodObject<{
+            file: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            inline: z.ZodString;
+        }, z.core.$strict>]>;
+        entrypoint: z.ZodOptional<z.ZodString>;
+        runtime: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodOptional<z.ZodString>;
+            timeout: z.ZodOptional<z.ZodNumber>;
+            memory: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        artifacts: z.ZodOptional<z.ZodObject<{
+            patterns: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+        dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$loose>;
+declare const skillFrontmatterSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    license: z.ZodOptional<z.ZodString>;
+    compatibility: z.ZodOptional<z.ZodString>;
+    "allowed-tools": z.ZodOptional<z.ZodString>;
+    metadata: z.ZodDefault<z.ZodObject<{
+        aip3: z.ZodOptional<z.ZodObject<{
+            schema: z.ZodLiteral<"skills/v1">;
+            variant: z.ZodDefault<z.ZodEnum<{
+                instruction: "instruction";
+                executable: "executable";
+                composite: "composite";
+            }>>;
+            version: z.ZodOptional<z.ZodString>;
+            tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            category: z.ZodOptional<z.ZodString>;
+            requires: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+            author: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+            uses: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            execution: z.ZodOptional<z.ZodObject<{
+                language: z.ZodEnum<{
+                    typescript: "typescript";
+                    javascript: "javascript";
+                    python: "python";
+                    shell: "shell";
+                }>;
+                code: z.ZodUnion<readonly [z.ZodObject<{
+                    file: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    inline: z.ZodString;
+                }, z.core.$strict>]>;
+                entrypoint: z.ZodOptional<z.ZodString>;
+                runtime: z.ZodOptional<z.ZodObject<{
+                    provider: z.ZodOptional<z.ZodString>;
+                    timeout: z.ZodOptional<z.ZodNumber>;
+                    memory: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
+                artifacts: z.ZodOptional<z.ZodObject<{
+                    patterns: z.ZodArray<z.ZodString>;
+                }, z.core.$strict>>;
+                dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, z.core.$strict>>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+type SkillFrontmatter = z.infer<typeof skillFrontmatterSchema>;
+type Aip3Extensions = z.infer<typeof aip3ExtensionsSchema>;
+
+export { type Aip3Extensions as A, type SkillDefinition as S, type SkillExecution as a, type SkillExecutionLanguage as b, type SkillFrontmatter as c, type SkillHandle as d, type SkillVariant as e, aip3ExtensionsSchema as f, skillFrontmatterSchema as s };

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@agentproto/skill",
+  "version": "0.2.0-alpha.0",
+  "description": "@agentproto/skill — AIP-3 SKILL.md reference implementation. A markdown + frontmatter format for distributing reusable agent skills as portable, version-controlled files.",
+  "keywords": [
+    "agentproto",
+    "aip-3",
+    "skill",
+    "defineSkill",
+    "open-standard",
+    "agentic"
+  ],
+  "homepage": "https://agentproto.sh/docs/aip-3",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentproto/ts",
+    "directory": "packages/skill"
+  },
+  "bugs": {
+    "url": "https://github.com/agentproto/ts/issues"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./manifest": {
+      "types": "./dist/manifest/index.d.ts",
+      "import": "./dist/manifest/index.mjs",
+      "default": "./dist/manifest/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "gray-matter": "^4.0.3",
+    "zod": "^4.4.3",
+    "@agentproto/define-doctype": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "@agentproto/tooling": "0.1.0-alpha.0"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  }
+}