Problem
As the repository grows, ensuring every contributed skill follows the strict anatomy defined in docs/skill-anatomy.md (YAML frontmatter, required sections, naming conventions) becomes a manual and error-prone review process.
Proposed Solution
I propose adding a lightweight GitHub Action that runs on every Pull Request. It will automatically validate any modified or added SKILL.md files to ensure they have:
Valid YAML frontmatter with name and description.
The name matches the directory name.
Required sections exist (## Overview, ## When to Use, ## Verification).
This offloads the mechanical review from maintainers and guarantees structural consistency.
If this sounds like a good addition, I'd be happy to submit a PR implementing this validation script and workflow.
Problem
As the repository grows, ensuring every contributed skill follows the strict anatomy defined in docs/skill-anatomy.md (YAML frontmatter, required sections, naming conventions) becomes a manual and error-prone review process.
Proposed Solution
I propose adding a lightweight GitHub Action that runs on every Pull Request. It will automatically validate any modified or added SKILL.md files to ensure they have:
Valid YAML frontmatter with name and description.
The name matches the directory name.
Required sections exist (## Overview, ## When to Use, ## Verification).
This offloads the mechanical review from maintainers and guarantees structural consistency.
If this sounds like a good addition, I'd be happy to submit a PR implementing this validation script and workflow.