prompt-authoring

What problem does it solve?

Authoring and maintaining .prompt.md evaluation files for hyoka can be error-prone without clear guidance on frontmatter formats, file structure, and filtering. This Skill provides expert guidance to ensure prompts are consistently formatted, properly categorized, and easy to validate across services, planes, and languages.

Core Features & Use Cases

• Clear frontmatter conventions (nested and flat formats) and migration guidance to keep prompts interoperable with the parser.
• Step-by-step guidance for structuring prompts, filtering tools, and applying best practices to improve prompt quality and evaluation reliability.
• Real-world use cases and patterns for organizing prompts under the prompts/ hierarchy, enabling scalable prompt authoring and maintenance.

Quick Start

Create a new prompt by following the recommended frontmatter formats and place the resulting .prompt.md file under prompts/{service}/{plane}/{language}/{slug}.prompt.md.