unknown-field

Validate SKILL.md frontmatter for required name and description fields.

1.0k|92|Updated May 22, 2026
One-click install
npx skills add https://github.com/open-gsd/gsd-pi --skill unknown-field-open-gsd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unknown-field
Source: https://github.com/open-gsd/gsd-pi/tree/main/packages/pi-coding-agent/test/fixtures/skills/unknown-field
Command: npx skills add https://github.com/open-gsd/gsd-pi --skill unknown-field-open-gsd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate frontmatter in SKILL.md to ensure the required fields name and description exist, and to tolerate additional non-critical fields without breaking discovery or loading.

Core Features & Use Cases

  • Enforces presence of required fields (name, description) for reliable discovery.
  • Gracefully ignores unknown or extra fields without failing validation.
  • Produces consistent metadata suitable for unit catalogs and tooling.

Quick Start

Validate the SKILL.md frontmatter to ensure it contains name and description, while ignoring extra fields.

Frequently Asked Questions about unknown-field

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate SKILL.md frontmatter for required fields and discoverability?

To validate SKILL.md frontmatter, you check that required fields like name and description exist while gracefully ignoring extra or unknown fields so discovery and loading remain unaffected.

What happens to unknown or extra fields in YAML frontmatter during skill metadata validation?

Unknown or extra YAML frontmatter fields are gracefully ignored during validation, ensuring non-critical metadata does not break skill discovery or loading processes.

How are dependencies and components determined during skill frontmatter validation?

Dependencies and components are determined by analyzing the skill's directory structure and contents, enforcing structural checks rather than relying solely on declared frontmatter fields.

Does frontmatter validation require strict schema compliance for skill discovery?

Frontmatter validation does not require strict schema compliance for skill discovery, as it tolerates additional non-critical fields and only enforces the presence of name and description.

What structured metadata outputs are generated from validating skill frontmatter?

Validating skill frontmatter produces consistent structured metadata suitable for unit catalogs and tooling, alongside a toxicity assessment derived from the directory structure and contents.

Why does unknown frontmatter affect skill discovery and how can I prevent it?

Unknown frontmatter can affect skill discovery if validation lacks tolerance, but you can prevent this by using a validation process that ignores extra fields and enforces only required fields.