---
title: "Skillset Schemas"
slug: "skillset/reference/schemas"

---
<!-- Generated by `bun run schema:generate`; do not edit directly. -->

<a id="skillset-schemas"></a>

Current schema artifact version: `0.1.0`. These files are generated from `@skillset/schema`; edit the schema contracts and run `bun run schema:generate` instead of editing the artifacts directly.

## Schemas

The combined schema is [`skillset.schema.json`](/skillset/reference/schemas/0.1.0/skillset.schema.json). Use the document-specific schemas below for editor file associations.

| Contract | Artifact | Purpose |
| --- | --- | --- |
| `workspace-config` | [`workspace-config.schema.json`](/skillset/reference/schemas/0.1.0/workspace-config.schema.json) | Skillset workspace configuration. |
| `plugin-config` | [`plugin-config.schema.json`](/skillset/reference/schemas/0.1.0/plugin-config.schema.json) | Skillset plugin configuration. |
| `source-metadata` | [`source-metadata.schema.json`](/skillset/reference/schemas/0.1.0/source-metadata.schema.json) | Shared source metadata for workspaces, plugins, and generated attribution. |
| `skill-frontmatter` | [`skill-frontmatter.schema.json`](/skillset/reference/schemas/0.1.0/skill-frontmatter.schema.json) | Adaptive Skillset skill frontmatter. |
| `agent-frontmatter` | [`agent-frontmatter.schema.json`](/skillset/reference/schemas/0.1.0/agent-frontmatter.schema.json) | Adaptive Skillset agent frontmatter. |
| `rule-frontmatter` | [`rule-frontmatter.schema.json`](/skillset/reference/schemas/0.1.0/rule-frontmatter.schema.json) | Adaptive Skillset rule frontmatter. |
| `hook` | [`hook.schema.json`](/skillset/reference/schemas/0.1.0/hook.schema.json) | Skillset hook definition source contract for aggregate hook event maps. |
| `adaptive-hook` | [`adaptive-hook.schema.json`](/skillset/reference/schemas/0.1.0/adaptive-hook.schema.json) | Skillset adaptive hook unit source contract for reusable portable hooks. |
| `change-entry` | [`change-entry.schema.json`](/skillset/reference/schemas/0.1.0/change-entry.schema.json) | Compatibility-only legacy pending change-entry frontmatter contract. |
| `test-declaration` | [`test-declaration.schema.json`](/skillset/reference/schemas/0.1.0/test-declaration.schema.json) | A deterministic Skillset test with optional explicit live-runtime activation assertions. |
| `skill-eval` | [`skill-eval.schema.json`](/skillset/reference/schemas/0.1.0/skill-eval.schema.json) | Portable skill-local eval cases compatible with Anthropic skill-creator. |

## Examples

The examples are generated from typed fixtures and checked against the same schema contracts before they are written.

| Contract | Example | Purpose |
| --- | --- | --- |
| `report` | [`report.json`](/skillset/reference/examples/report.json) | Immutable Skillset typed operational report receipt. |
| `workspace-config` | [`workspace-config.yaml`](/skillset/reference/examples/workspace-config.yaml) | Maximal workspace manifest; defaults.codex.agents configures project-agent rendering, not Agent standards selection. |
| `plugin-config` | [`plugin-config.yaml`](/skillset/reference/examples/plugin-config.yaml) | Maximal plugin manifest for a Skillset plugin. |
| `source-metadata` | [`source-metadata.yaml`](/skillset/reference/examples/source-metadata.yaml) | Shared source metadata used under the skillset key. |
| `skill-frontmatter` | [`skill-frontmatter.yaml`](/skillset/reference/examples/skill-frontmatter.yaml) | Adaptive skill frontmatter; allowed_tools.agents is Agent Skills tool policy, not a provider or standards selector. |
| `agent-frontmatter` | [`agent-frontmatter.yaml`](/skillset/reference/examples/agent-frontmatter.yaml) | Adaptive project-agent frontmatter. |
| `rule-frontmatter` | [`rule-frontmatter.yaml`](/skillset/reference/examples/rule-frontmatter.yaml) | Adaptive rule frontmatter. |
| `hook` | [`hook.yaml`](/skillset/reference/examples/hook.yaml) | Hook definition source object. |
| `adaptive-hook` | [`adaptive-hook.yaml`](/skillset/reference/examples/adaptive-hook.yaml) | Adaptive reusable hook unit. |
| `change-entry` | [`change-entry.yaml`](/skillset/reference/examples/change-entry.yaml) | Compatibility-only legacy pending change-entry frontmatter. |
| `skill-eval` | [`skill-eval.json`](/skillset/reference/examples/skill-eval.json) | Skill-local portable eval cases compatible with Anthropic skill-creator. |
| `test-declaration` | [`test-declaration.yaml`](/skillset/reference/examples/test-declaration.yaml) | Deterministic test with an explicit live-runtime activation assertion. |

## Editor Integration

Workspace manifests can use the YAML language-server comment `# yaml-language-server: $schema=https://raw.githubusercontent.com/outfitter-dev/skillset/main/docs/reference/schemas/0.1.0/workspace-config.schema.json`. Skillset scaffolds this comment because the manifest schema is strict and should not need an extra `$schema` key in authored YAML.

Rule frontmatter is published as [`rule-frontmatter.schema.json`](/skillset/reference/schemas/0.1.0/rule-frontmatter.schema.json) with no alias at its previous file name. Editor associations that still point at the file retired by [ADR-0039](https://github.com/outfitter-dev/skillset/blob/24800e02ed4e7150ea1bc7130c35603c98ea9da2/docs/adrs/0039-rules-name-authored-guidance-source.md) must switch to `https://raw.githubusercontent.com/outfitter-dev/skillset/main/docs/reference/schemas/0.1.0/rule-frontmatter.schema.json`.