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

说明与用途

frontmatter-guard 检测 Claude Code 技能 frontmatter 中的拼写错误，避免官方验证器忽略导致的隐式错误。

问题

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.

来源