Your Skill's Frontmatter Has a Typo. Nothing Will Ever Tell You

Описание и применение

Инструмент frontmatter-guard обнаруживает опечатки в frontmatter навыков Claude Code, которые официальный валидатор пропускает, предотвращая неявные ошибки.

Задача

A typo in a Claude Code skill’s frontmatter (e.g., an unknown key or misspelled hook event) can silently pass validation and never trigger the intended behavior.

Результат

frontmatter-guard catches typos that the official validator misses, preventing silent failures and ensuring that all declared keys and hook events are valid and functional.

Рабочий процесс

• Install the tool: pip install frontmatter-guard
• Run the linter against the skill directory: frontmatter-guard check . --strict
• Review the output for errors such as unknown-key or unknown-hook-event
• Fix the reported issues in the frontmatter
• Re‑run the linter to confirm no errors remain

Доказательства

effort: high was supposed to keep the model from going overboard. I ran claude plugin validate before shipping. It passed. Green. Ship it.

Источник

commands/deploy.md:4: error [unknown-key] Unknown key 'effort'. fix: Remove the key -- unknown keys are silently ignored, so it currently does nothing.

Источник