chore: normalize skills-ref frontmatter#64
chore: normalize skills-ref frontmatter#64dallascrilley wants to merge 2 commits intomvanhorn:mainfrom
Conversation
|
Validation summary:\n- ✅\n- Valid skill: variants/open ✅\n\nScope is intentionally limited to frontmatter normalization for compatibility. Skill behavior and body instructions are unchanged. |
|
Validation summary:
Scope is intentionally limited to frontmatter normalization for |
mvanhorn
left a comment
There was a problem hiding this comment.
Thanks for the contribution, but I need to request changes here — this PR removes fields that are required for the skill to function in Claude Code:
user-invocable: true— without this, the skill doesn't appear as a slash commandallowed-tools— defines the security boundary for what tools the skill can useargument-hint— provides usage examples in the CLIversion— required for the plugin distribution system (current main is at 2.9.5, this branch has 2.8)- The
metadatablock — contains dependency declarations and discovery tags
The variant rename from name: last30days to name: "open" would also break variant detection.
Could you share what "skills-ref validator" flagged these fields? Claude Code's skill spec supports all of them. If there's a specific validator with different requirements, I'd like to understand the gap — but removing these fields would break the skill entirely.
Review assisted by Claude Code
|
Hey, sorry for the delay on this one - it's been a wild couple of weeks. We hit #1 trending on GitHub and the flood of activity has been hard to keep up with. The frontmatter normalization is clean and the validation summary is helpful. I'm holding off on all merges until the v3.0 refactor lands since it changes the skill file structure, but I promise I'll consider this once things settle. Appreciate the quality contribution. |
Normalize SKILL frontmatter to pass the official skills-ref validator.\n\n- remove unsupported top-level fields from frontmatter\n- preserve metadata within supported fields\n- keep skill behavior unchanged\n\nValidation:\n- skills-ref validate .\n- skills-ref validate variants/open\n