unknown-field

Validate YAML frontmatter for required name and description fields.

1|Updated Jul 13, 2026
One-click install
npx skills add https://github.com/vh2224/forge-executor --skill unknown-field-vh2224
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unknown-field
Source: https://github.com/vh2224/forge-executor/tree/main/packages/pi-coding-agent/test/fixtures/skills/unknown-field
Command: npx skills add https://github.com/vh2224/forge-executor --skill unknown-field-vh2224

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps identify and handle Skill files that contain extra or nonstandard YAML frontmatter fields, making it easier to assess metadata quality without breaking valid discovery rules.

Core Features & Use Cases

  • Frontmatter Validation: Confirms the required name and description fields are present while tolerating unknown keys.
  • Metadata Inspection: Useful when reviewing contributed skills that may include additional fields like author, version, or custom annotations.
  • Use Case: A repository maintainer can quickly verify that a Skill is still discoverable even if it includes extra metadata for internal tracking.

Quick Start

Review the SKILL.md frontmatter and confirm the required fields are present before deciding whether the extra metadata should be kept or ignored.

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 nonstandard metadata fields?

YAML frontmatter validation requires parsing the metadata to confirm the required name and description fields are present while safely ignoring extra unknown keys. This approach ensures valid skill discovery without breaking existing repository audit rules.

Why does extra metadata in a Skill file not break discovery rules?

Extra metadata does not break discovery rules because validation logic preserves required name and description fields while tolerating unknown keys. This allows contributed skills to include custom annotations or internal tracking fields without affecting standard skill ingestion checks.

What is the best way to audit Skill files for metadata quality?

The best way to audit Skill files for metadata quality is to parse the YAML frontmatter and verify the presence of required fields while flagging nonstandard metadata. This approach helps maintainers assess contributed skills and decide whether extra metadata should be kept or ignored.

Can I use frontmatter validation for repository audits of contributed skills?

Yes, you can use frontmatter validation for repository audits of contributed skills. It checks that Skills remain discoverable by verifying required name and description fields, making it useful for metadata normalization workflows and skill ingestion checks even when custom annotations are present.

How do I normalize skill metadata without losing custom annotations?

To normalize skill metadata without losing custom annotations, parse the YAML frontmatter to confirm required name and description fields are present while tolerating extra keys. This preserves internal tracking data during metadata normalization workflows without breaking discovery rules.