Best-Practice Creator

Create and validate Opensquad best-practice files with required frontmatter and sections.

Updated Mar 25, 2026

Search Tags:#automation #versioning #documentation #validation #catalog #best-practices #cross-reference

Ready to run

npx skills add https://github.com/FredericoMatsuoka/porsche-search-glow --skill best-practice-creator-fredericomatsuoka

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: Best-Practice Creator
Source: https://github.com/FredericoMatsuoka/porsche-search-glow/tree/main/skills/opensquad-agent-creator
Command: npx skills add https://github.com/FredericoMatsuoka/porsche-search-glow --skill best-practice-creator-fredericomatsuoka

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guides creation and maintenance of best-practice files for the Opensquad best-practices library. Handles format validation, cross-references, versioning, and catalog consistency.

Core Features & Use Cases

Automates pre-flight checks across best-practice files, ensuring consistency with the catalog.
Validates frontmatter and required sections, and coordinates cross-references to avoid overlaps.
Scans the _opensquad/core/best-practices catalog and current skills' SKILL.md files to align content.

Quick Start

Run the Best-Practice Creator workflow to scaffold and validate a new best-practice file for the Opensquad library.

Frequently Asked Questions about Best-Practice Creator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I automate best-practice file creation for a documentation catalog?▼

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.

What is best-practice versioning and cross-reference validation in a documentation library?▼

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.

How do I validate frontmatter and required sections in best-practice Markdown files?▼

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.

What's the best way to update a best-practices catalog and avoid content overlaps?▼

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.

When do I need to enforce versioning and cross-references for best-practice documentation?▼

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.