Skip to content

skill-tags

Skill tags must be an array of strings

Error

Rule Details

The tags frontmatter field helps categorize and discover skills. When present, it must be a YAML array of strings. This rule delegates to the skill frontmatter Zod schema for validation, reporting the first schema violation found. Invalid tag formats prevent proper skill indexing and search functionality.

Incorrect

Tags as a single string instead of an array

yaml
---
name: deploy-app
tags: deployment
---

Tags array containing non-string values

yaml
---
name: deploy-app
tags:
  - deployment
  - 123
---

Correct

Valid tags array

yaml
---
name: deploy-app
tags:
  - deployment
  - ci-cd
  - production
---

No tags field (tags are optional)

yaml
---
name: deploy-app
description: Deploys the application
---

How To Fix

Ensure the tags field is a YAML array of strings. Each tag should be on its own line prefixed with -. Remove any non-string values from the array.

Options

This rule does not have any configuration options.

Resources

Version

Available since: v0.2.0