skill-maintenance

To validate SKILL.md frontmatter, run preflight checks that surface gaps and fix inconsistencies while maintaining alignment with CLAUDE.md/AGENTS.md rules. This ensures structure, section, asset, and trigger requirements are satisfied with traceable change history.

The best way to update SKILL.md is applying guided, minimal-diff changes using Subagent QC loops. This workflow validates modifications and reflects backlog rules across environments, ensuring documentation stays healthy without unnecessary alterations.

Yes, pyyaml is required as a dependency to run SKILL.md validation workflows. It enables the scripts component to parse frontmatter, execute preflight checks, and process structured YAML metadata during the maintenance cycle.

A Subagent QC loop works by running evaluation scripts after making minimal-diff updates to SKILL.md, checking whether structure, section, asset, and trigger requirements are satisfied. It traces change history and validates alignment before finalizing modifications.

Yes, you can synchronize SKILL.md backlog updates across multiple environments. The maintenance workflow applies cross-environment synchronization to keep standards consistent, reflecting backlog rules and ensuring traceable validation steps throughout.

Preflight checks fail when new triggers do not satisfy structure, section, asset, and trigger requirements defined in the workflow. The validation scripts surface these gaps, requiring minimal-diff fixes and alignment verification before changes pass the QC loop.