Skillset Schemas
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. Use the document-specific schemas below for editor file associations.
| Contract | Artifact | Purpose |
|---|---|---|
workspace-config |
workspace-config.schema.json |
Skillset workspace configuration. |
plugin-config |
plugin-config.schema.json |
Skillset plugin configuration. |
source-metadata |
source-metadata.schema.json |
Shared source metadata for workspaces, plugins, and generated attribution. |
skill-frontmatter |
skill-frontmatter.schema.json |
Adaptive Skillset skill frontmatter. |
agent-frontmatter |
agent-frontmatter.schema.json |
Adaptive Skillset agent frontmatter. |
rule-frontmatter |
rule-frontmatter.schema.json |
Adaptive Skillset rule frontmatter. |
hook |
hook.schema.json |
Skillset hook definition source contract for aggregate hook event maps. |
adaptive-hook |
adaptive-hook.schema.json |
Skillset adaptive hook unit source contract for reusable portable hooks. |
change-entry |
change-entry.schema.json |
Compatibility-only legacy pending change-entry frontmatter contract. |
test-declaration |
test-declaration.schema.json |
A deterministic Skillset test with optional explicit live-runtime activation assertions. |
skill-eval |
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 |
Immutable Skillset typed operational report receipt. |
workspace-config |
workspace-config.yaml |
Maximal workspace manifest; defaults.codex.agents configures project-agent rendering, not Agent standards selection. |
plugin-config |
plugin-config.yaml |
Maximal plugin manifest for a Skillset plugin. |
source-metadata |
source-metadata.yaml |
Shared source metadata used under the skillset key. |
skill-frontmatter |
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 |
Adaptive project-agent frontmatter. |
rule-frontmatter |
rule-frontmatter.yaml |
Adaptive rule frontmatter. |
hook |
hook.yaml |
Hook definition source object. |
adaptive-hook |
adaptive-hook.yaml |
Adaptive reusable hook unit. |
change-entry |
change-entry.yaml |
Compatibility-only legacy pending change-entry frontmatter. |
skill-eval |
skill-eval.json |
Skill-local portable eval cases compatible with Anthropic skill-creator. |
test-declaration |
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 with no alias at its previous file name. Editor associations that still point at the file retired by ADR-0039 must switch to https://raw.githubusercontent.com/outfitter-dev/skillset/main/docs/reference/schemas/0.1.0/rule-frontmatter.schema.json.