conventions

Enforce conventions for GitHub Actions YAML, gh-aw Markdown, and blueprint frontmatter.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/xiaolai/awful-for-claude --skill conventions-xiaolai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: conventions
Source: https://github.com/xiaolai/awful-for-claude/tree/main/skills/awful/conventions
Command: npx skills add https://github.com/xiaolai/awful-for-claude --skill conventions-xiaolai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The conventions guide ensures consistent generation of workflow files, blueprints, and templates by standardizing gh-aw Markdown, GitHub Actions YAML, and blueprint frontmatter across projects.

Core Features & Use Cases

  • Standardizes frontmatter schemas and templates for gh-aw workflows
  • Provides a reusable blueprint and template structure for scalable automation
  • Helps teams validate and align on a common formatting standard across repos

Quick Start

Use the conventions guide to format gh-aw markdown, GitHub Actions YAML, and blueprint frontmatter for your workflows.

Frequently Asked Questions about conventions

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

FAQPage Schema
What are frontmatter conventions for GitHub Actions YAML and gh-aw markdown?

Frontmatter conventions standardize the schemas and template structures required for generating GitHub Actions YAML, gh-aw Markdown, and blueprints, ensuring automated agent workflows meet required formatting and integration points across repositories.

How do I standardize GitHub Actions workflows and blueprint templates across multiple repositories?

You standardize GitHub Actions workflows and blueprint templates by applying a conventions guide that enforces consistent frontmatter schemas and template structures, providing a reusable formatting standard for scalable automation across your repositories.

Do I need frontmatter schemas to validate gh-aw markdown workflows?

Yes, frontmatter schemas are required to validate gh-aw markdown workflows, ensuring the template structures and formatting meet the required integration points for automated agent workflows to function correctly.

What is the best way to format blueprint frontmatter for automated agent workflows?

The best way to format blueprint frontmatter is to follow a standardized conventions guide that clarifies and enforces the required schemas and template structures, ensuring seamless integration for automated agent workflows.

Why does my GitHub Actions YAML generation fail consistency checks across different repositories?

GitHub Actions YAML generation fails consistency checks when frontmatter schemas and template structures lack standardization, preventing the project from meeting the required formatting standards and integration points for automated workflows.

Can I use these conventions to validate template structures without GitHub Actions?

Yes, the conventions apply to projects that generate, validate, and template workflows, blueprints, and templates, enforcing frontmatter schemas and template structures beyond just GitHub Actions YAML generation.