# Schema

> An agent skill providing instructions for AI agents.

- Skill: `stencila/schema` (Agent Skill, multi-file: 220 files)
- Install (CLI): `npx skillmds@latest add stencila/schema`
- Raw SKILL.md: https://api.skillmd.com/api/skills/stencila/schema/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: stencila (https://skillmd.com/u/stencila)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/stencila/schema

---


This is an implementation of the [Agent Skills
Specification](https://agentskills.io/specification).

In Stencila Schema it represents a reusable skill package for AI agents,
modeled as a creative work with structured metadata, instructions, and tool
constraints. Stencila uses this type to describe skills that can be discovered
cheaply from summary metadata and then expanded into full instructions when the
skill is activated.

Key properties include `name`, `frontmatter`, `content`, `compatibility`, and
`allowedTools`.


# Analogues

The following external types, elements, or nodes are similar to a `Skill`:

- [Agent Skills Specification skill](https://agentskills.io/specification): Direct analogue and source specification for reusable agent skills.

# Properties

The `Skill` type has these properties:

| Name             | Description                                                                                                             | Type                                                                              | Inherited from                       |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------ |
| `name`           | The name of the skill.                                                                                                  | [`String`](./string.md)                                                           | -                                    |
| `frontmatter`    | Frontmatter containing skill metadata.                                                                                  | [`String`](./string.md)                                                           | -                                    |
| `content`        | The content of the skill (the Markdown body).                                                                           | [`Block`](./block.md)*                                                            | -                                    |
| `compatibility`  | Environment requirements for the skill.                                                                                 | [`String`](./string.md)                                                           | -                                    |
| `allowedTools`   | Pre-approved tools for the skill.                                                                                       | [`String`](./string.md)*                                                          | -                                    |
| `workType`       | The type of `CreativeWork` (e.g. article, book, software application).                                                  | [`CreativeWorkType`](./creative-work-type.md)                                     | [`CreativeWork`](./creative-work.md) |
| `doi`            | The work's Digital Object Identifier (https://doi.org/).                                                                | [`String`](./string.md)                                                           | [`CreativeWork`](./creative-work.md) |
| `about`          | The subject matter of the content.                                                                                      | [`ThingVariant`](./thing-variant.md)*                                             | [`CreativeWork`](./creative-work.md) |
| `abstract`       | A short description that summarizes a `CreativeWork`.                                                                   | [`Block`](./block.md)*                                                            | [`CreativeWork`](./creative-work.md) |
| `authors`        | The authors of the `CreativeWork`.                                                                                      | [`Author`](./author.md)*                                                          | [`CreativeWork`](./creative-work.md) |
| `provenance`     | A summary of the provenance of the content within the work.                                                             | [`ProvenanceCount`](./provenance-count.md)*                                       | [`CreativeWork`](./creative-work.md) |
| `contributors`   | A secondary contributor to the `CreativeWork`.                                                                          | [`Author`](./author.md)*                                                          | [`CreativeWork`](./creative-work.md) |
| `editors`        | People who edited the `CreativeWork`.                                                                                   | [`Person`](./person.md)*                                                          | [`CreativeWork`](./creative-work.md) |
| `maintainers`    | The maintainers of the `CreativeWork`.                                                                                  | ([`Person`](./person.md) \| [`Organization`](./organization.md))*                 | [`CreativeWork`](./creative-work.md) |
| `comments`       | Comments about this creative work.                                                                                      | [`Comment`](./comment.md)*                                                        | [`CreativeWork`](./creative-work.md) |
| `dateCreated`    | Date/time of creation.                                                                                                  | [`DateTime`](./date-time.md)                                                      | [`CreativeWork`](./creative-work.md) |
| `dateReceived`   | Date/time that work was received.                                                                                       | [`DateTime`](./date-time.md)                                                      | [`CreativeWork`](./creative-work.md) |
| `dateAccepted`   | Date/time of acceptance.                                                                                                | [`DateTime`](./date-time.md)                                                      | [`CreativeWork`](./creative-work.md) |
| `dateModified`   | Date/time of most recent modification.                                                                                  | [`DateTime`](./date-time.md)                                                      | [`CreativeWork`](./creative-work.md) |
| `datePublished`  | Date of first publication.                                                                                              | [`DateTime`](./date-time.md)                                                      | [`CreativeWork`](./creative-work.md) |
| `funders`        | People or organizations that funded the `CreativeWork`.                                                                 | ([`Person`](./person.md) \| [`Organization`](./organization.md))*                 | [`CreativeWork`](./creative-work.md) |
| `fundedBy`       | Grants that funded the `CreativeWork`; reverse of `fundedItems`.                                                        | ([`Grant`](./grant.md) \| [`MonetaryGrant`](./monetary-grant.md))*                | [`CreativeWork`](./creative-work.md) |
| `genre`          | Genre of the creative work, broadcast channel or group.                                                                 | [`String`](./string.md)*                                                          | [`CreativeWork`](./creative-work.md) |
| `keywords`       | Keywords or tags used to describe this content. Multiple entries in a keywords list are typically delimited by commas.  | [`String`](./string.md)*                                                          | [`CreativeWork`](./creative-work.md) |
| `isPartOf`       | An item or other CreativeWork that this CreativeWork is a part of.                                                      | [`CreativeWorkVariant`](./creative-work-variant.md)                               | [`CreativeWork`](./creative-work.md) |
| `licenses`       | License documents that applies to this content, typically indicated by URL, but may be a `CreativeWork` itself.         | ([`CreativeWorkVariant`](./creative-work-variant.md) \| [`String`](./string.md))* | [`CreativeWork`](./creative-work.md) |
| `parts`          | Elements of the collection which can be a variety of different elements, such as Articles, Datatables, Tables and more. | [`CreativeWorkVariant`](./creative-work-variant.md)*                              | [`CreativeWork`](./creative-work.md) |
| `publisher`      | A publisher of the CreativeWork.                                                                                        | [`Person`](./person.md) \| [`Organization`](./organization.md)                    | [`CreativeWork`](./creative-work.md) |
| `bibliography`   | A bibliography of references which may be cited in the work.                                                            | [`Bibliography`](./bibliography.md)                                               | [`CreativeWork`](./creative-work.md) |
| `references`     | References to other creative works, such as another publication, web page, scholarly article, etc.                      | [`Reference`](./reference.md)*                                                    | [`CreativeWork`](./creative-work.md) |
| `text`           | The textual content of this creative work.                                                                              | [`Text`](./text.md)                                                               | [`CreativeWork`](./creative-work.md) |
| `title`          | The title of the creative work.                                                                                         | [`Inline`](./inline.md)*                                                          | [`CreativeWork`](./creative-work.md) |
| `repository`     | URL of the repository where the un-compiled, human readable source of the work is located.                              | [`String`](./string.md)                                                           | [`CreativeWork`](./creative-work.md) |
| `path`           | The file system path of the source of the work.                                                                         | [`String`](./string.md)                                                           | [`CreativeWork`](./creative-work.md) |
| `commit`         | The commit hash (or similar) of the source of the work.                                                                 | [`String`](./string.md)                                                           | [`CreativeWork`](./creative-work.md) |
| `worktreeStatus` | The status of the source worktree relative to the commit.                                                               | [`WorktreeStatus`](./worktree-status.md)                                          | [`CreativeWork`](./creative-work.md) |
| `version`        | The version of the creative work.                                                                                       | [`String`](./string.md) \| [`Number`](./number.md)                                | [`CreativeWork`](./creative-work.md) |
| `alternateNames` | Alternate names (aliases) for the item.                                                                                 | [`String`](./string.md)*                                                          | [`Thing`](./thing.md)                |
| `description`    | A description of the item.                                                                                              | [`String`](./string.md)                                                           | [`Thing`](./thing.md)                |
| `identifiers`    | Any kind of identifier for any kind of Thing.                                                                           | ([`PropertyValue`](./property-value.md) \| [`String`](./string.md))*              | [`Thing`](./thing.md)                |
| `images`         | Images of the item.                                                                                                     | [`ImageObject`](./image-object.md)*                                               | [`Thing`](./thing.md)                |
| `url`            | The URL of the item.                                                                                                    | [`String`](./string.md)                                                           | [`Thing`](./thing.md)                |
| `id`             | The identifier for this item.                                                                                           | [`String`](./string.md)                                                           | [`Entity`](./entity.md)              |

# Related

The `Skill` type is related to these types:

- Parents: [`CreativeWork`](./creative-work.md)
- Children: none

# Bindings

The `Skill` type is represented in:

- [JSON-LD](https://stencila.org/Skill.jsonld)
- [JSON Schema](https://stencila.org/Skill.schema.json)
- Python class [`Skill`](https://github.com/stencila/stencila/blob/main/python/stencila_types/src/stencila_types/types.py)
- Rust struct [`Skill`](https://github.com/stencila/stencila/blob/main/rust/schema/src/types/skill.rs)
- TypeScript class [`Skill`](https://github.com/stencila/stencila/blob/main/ts/src/types/Skill.ts)

***

This documentation was generated from [`Skill.yaml`](https://github.com/stencila/stencila/blob/main/schema/Skill.yaml) by [`docs_types.rs`](https://github.com/stencila/stencila/blob/main/rust/schema-gen/src/docs_types.rs).

