ensuring-prompt-quality

What problem does it solve?

This Skill automates the quality review of prompt files across the .agents workspace, catching issues in naming, structure, triggers, and trainer guidelines to save reviewers time and ensure consistent, high-quality prompts.

Core Features & Use Cases

• Frontmatter validation: Ensures name length (max 64 chars), lowercase/hyphen only, presence of required fields, and proper description with third-person perspective and triggers.
• Structural checks: Verifies headings, table of contents inclusion for long files, and 500-line guidance for SKILL.md-like entries.
• Content consistency: Detects duplications or conflicts across related files, ensures consistent terminology and style.
• Automatic reporting: Generates a validation report with findings to guide improvements.
• Use Case: After creating or editing rules, skills, agents, or commands in .agents/, run this Skill to ensure the entire prompt family adheres to guidelines before release.

Quick Start

Run the quality validator on the Ensuring Prompt Quality skill directory: use a command like "validate-prompt-quality .agents/skills/ensuring-prompt-quality" to produce a report of any issues and suggested fixes.