skills.rest
Oxilith
OxilithCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

unexpected-keys

Validate YAML frontmatter in SKILL.md files for required and unexpected keys.

Updated Aug 27, 2026
Search Tags:#linting#validation#tooling#yaml#metadata#quality-assurance#frontmatter
One-click install
npx skills add https://github.com/Oxilith/CopilotSkills --skill unexpected-keys
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unexpected-keys
Source: https://github.com/Oxilith/CopilotSkills/tree/main/.agentskills/__tests__/fixtures/invalid_skills/unexpected-keys
Command: npx skills add https://github.com/Oxilith/CopilotSkills --skill unexpected-keys

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill identifies and reports unexpected keys in SKILL.md frontmatter to ensure consistent and compliant Skill discovery.

Core Features & Use Cases

  • Frontmatter validation: detects required fields and flags unknown keys.
  • Compliance reporting: provides a concise summary for catalog integration.
  • Use Case: Before publishing a new Skill, run this validator to guarantee the frontmatter adheres to the schema.

Quick Start

Run the frontmatter validator on the target Skill directory to surface any unexpected keys or missing required fields.

Frequently Asked Questions about unexpected-keys

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

FAQPage Schema
How do I validate YAML frontmatter in SKILL.md files before publishing?▼

YAML frontmatter validation checks SKILL.md files to enforce key rules, detecting required fields and flagging unknown keys. It ensures consistent metadata compliance before publishing new Skill Units.

Why does my Skill discovery tool fail when parsing unexpected frontmatter keys?▼

Skill discovery fails because unexpected keys in SKILL.md frontmatter break downstream tooling metadata parsing. Validating frontmatter enforces required fields and removes unknown keys to ensure compliant Skill discovery.

What is the best way to lint SKILL.md metadata for quality assurance?▼

Linting SKILL.md metadata involves running a frontmatter validator to enforce key presence and detect unknown keys. This provides concise compliance reporting for quality assurance and catalog integration.

Can I check for missing required fields in SKILL.md frontmatter automatically?▼

You can check for missing required fields automatically by running a frontmatter validator on the target Skill directory. It parses SKILL.md metadata and reports validation results for catalog integration.

When do I need to run a frontmatter validation check on my Skill repository?▼

You need frontmatter validation when discovering Skill Units across a repository and parsing metadata for downstream tooling. Run it before publishing a new Skill to guarantee schema compliance.

Related Skills

Explore More Software Engineering Skills→
pradyumnasagarpradyumnasagar
6

roadmap-author

Guide authors through creating and validating ORS SKILL.md files.

Community
Intermediate
pradyumnasagarpradyumnasagar
6

cross-reference-mapper

Generate and validate cross-references between ORS skills.

Community
Intermediate
nopperabbonopperabbo
7

k8s-yaml-validator

Validate Kubernetes YAML manifests with linting, CRD detection, and schema verification.

Community
Advanced
hyperbolic-chyperbolic-c
5

requirement-parser

Parse YAML frontmatter from Markdown requirement files and validate required fields.

Community
Intermediate