unknown-field

Validate SKILL.md frontmatter with non-standard fields while enforcing required entries.

484|76|Updated Oct 23, 2025
One-click install
npx skills add https://github.com/bastani-inc/atomic --skill unknown-field-bastani-inc
Or copy as Structured Prompt for Agentā–¼
Please help me install this Agent Skill.
Skill: unknown-field
Source: https://github.com/bastani-inc/atomic/tree/main/packages/coding-agent/test/fixtures/skills/unknown-field
Command: npx skills add https://github.com/bastani-inc/atomic --skill unknown-field-bastani-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps validate skill definitions that include extra frontmatter fields without breaking discovery or loading.

Core Features & Use Cases

  • Frontmatter Tolerance: Accepts non-standard fields alongside the required name and description entries.
  • Skill Validation: Supports checks for skill metadata files that must remain compatible even when authors add custom keys.
  • Use Case: Use it when a skill author adds optional metadata such as ownership or versioning and you want to keep the skill valid.

Quick Start

Ask the AI to review a skill file and confirm that its required frontmatter is present while preserving any unknown 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 YAML frontmatter with extra fields without rejecting the file?ā–¼

YAML frontmatter validation can preserve extra fields by enforcing mandatory name and description entries while accepting non-standard metadata keys alongside them. This keeps skill files valid during discovery workflows.

Why does skill parsing fail when I add custom metadata to frontmatter?ā–¼

Skill parsing fails on custom metadata when validators strictly reject unknown YAML frontmatter keys. You need a tolerance mechanism that accepts non-standard fields while still enforcing required name and description entries.

Can I include custom keys in SKILL.md frontmatter and keep the skill valid?ā–¼

You can include custom keys in SKILL.md frontmatter and keep the skill valid by using validation that accepts extra metadata fields. This ensures files remain compatible for packaging and discovery without rejecting author-defined keys.

What's the best way to check skill metadata files for required fields without losing optional data?ā–¼

The best way to check skill metadata files is applying YAML parsing that enforces mandatory name and description fields while preserving unknown frontmatter keys. This validates structure without discarding author-defined metadata.

Does frontmatter validation support non-standard YAML fields for skill discovery?ā–¼

Frontmatter validation supports non-standard YAML fields for skill discovery by checking required entries while ignoring extra keys. This allows skill authors to add optional metadata like ownership or versioning safely.

Are there limitations to allowing unknown fields in skill frontmatter?ā–¼

Allowing unknown fields in skill frontmatter lacks strict schema enforcement for custom keys, meaning invalid data types in extra metadata fields will not be caught. Validation focuses only on mandatory name and description entries.