Skip to content

feat: add CI linter to enforce skill anatomy standards automatically #233

@LorenzaVolponi

Description

@LorenzaVolponi

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions