quality-check

To validate AI skill metadata before a pull request, run an automated pre-commit check to lint YAML frontmatter, enforce description length, and verify required update notice blocks in your skill directories.

Duplicate trigger phrases cause AI agent routing errors because overlapping skill descriptions create semantic conflicts, making the agent unable to disambiguate which skill to execute for a given prompt.

You can check for broken cross-references in skill directories by running an automated validation script that resolves file links within SKILL.md entry points and flags any missing targets.

Yes, pre-commit linting works with YAML frontmatter in SKILL.md files by automatically parsing the metadata to enforce structural compliance, validate required fields, and ensure trigger uniqueness.

The best way to prevent broken documentation links in AI workflows is to integrate automated cross-reference resolution into your pre-PR validation process to catch missing file targets before merging.

Yes, you need PyYAML installed as a dependency to run automated compliance checks, because the validation logic parses YAML frontmatter in SKILL.md files to enforce structural and metadata rules.