Canonical source for agents: Allowed values and validation rules live in
.agents/skills/content-metadata/SKILL.md in this repository. This article is the human-readable reference; when the two differ, the skill is authoritative.Metadata values are case-sensitive.
Example YAML frontmatter
Required fields
Every article must include all of the following fields.Optional fields
Content metadata fields
The following fields are required in every article. They classify articles for reporting, search discoverability, and AI answer precision.Audience
Theaudience field defines the main target audience for the article.
Valid values for the audience field:
Content type
Thecontent-type field defines the type of content in the article. It matches the content types defined in the content model.
Valid values for the content-type field:
Article type
Thearticle-type field defines the type of article, map topic or article, and is used for reporting.
Valid values for the article-type field:
Experience level
We use theexperience-level field to define the experience level we expect the reader of the article to have. It is used for reporting.
Valid values for the experience-level field:
Lifecycle
We use thelifecycle field to define which part of the customer lifecycle the article is intended for. It is used for reporting.
Valid values for the lifecycle field: