Best-Practice Creator

Automating best-practice file creation involves scaffolding Markdown files with required frontmatter like id, name, whenToUse, and version. This process ensures documentation consistency by validating required sections such as Core Principles and Quality Criteria within the catalog.

Best-practice versioning and cross-reference validation is the process of enforcing unique identifiers and tracking document versions. It scans the catalog and current SKILL.md files to coordinate references, preventing content overlaps and maintaining library consistency.

To validate frontmatter and required sections in Markdown files, run pre-flight checks that enforce frontmatter requirements and verify the body includes mandatory sections like Core Principles, Techniques, Quality Criteria, and an example-driven structure.

The best way to update a best-practices catalog and avoid overlaps is scanning the repository catalog and existing SKILL.md files. This aligns new content, coordinates cross-references, and enforces structural consistency across the library.

You need to enforce versioning and cross-references for best-practice documentation when defining new practices or updating an existing catalog. This ensures format validation, prevents reference overlaps, and maintains consistency across the Opensquad library.