Best-Practice Creator

Automate creation and maintenance of Opensquad best-practice files with YAML validation.

2.0k|522|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/renatoasse/opensquad --skill best-practice-creator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Best-Practice Creator
Source: https://github.com/renatoasse/opensquad/tree/main/skills/opensquad-agent-creator
Command: npx skills add https://github.com/renatoasse/opensquad --skill best-practice-creator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

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

Core Features & Use Cases

  • Validates and scaffolds new best-practice files
  • Checks cross-references against catalog and existing practices
  • Manages versioning and catalog placement
  • Provides templates and consistency enforcement across the library

Quick Start

Create a new best-practice file by following the workflow and update the catalog accordingly.

Frequently Asked Questions about Best-Practice Creator

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

FAQPage Schema
How do I create and validate best-practice files with YAML frontmatter?

To create best-practice files, use a workflow that scaffolds the file, enforces YAML frontmatter structure, validates required sections, and checks cross-references against an existing catalog before saving.

What is the best way to maintain versioning and catalog consistency for documentation?

Maintaining versioning and catalog consistency requires a workflow that manages catalog placement, updates version numbers, and cross-references scopes to keep documentation libraries synchronized.

How do I validate formatting and cross-references in a documentation library?

Validating formatting and cross-references involves enforcing YAML frontmatter rules, checking required sections, and verifying links against the central catalog using post-creation validation checks.

Can I use templates to scaffold new documentation entries automatically?

Yes, you can use templates to scaffold new documentation entries automatically, applying predefined structures that enforce consistency across the library and streamline file creation.

Why does my best-practice file fail post-creation validation checks?

Best-practice files fail validation when they lack required YAML frontmatter fields, miss mandatory sections, or contain scope cross-references that do not match existing entries in the central catalog.

Do I need to update the central catalog manually after adding a new best-practice entry?

No, the workflow automates central catalog updates after adding a new best-practice entry, ensuring the catalog reflects new files and maintaining cross-reference consistency automatically.