moai-alfred-spec-metadata-validation

Validate SPEC YAML frontmatter for required fields and HISTORY compliance.

1.2k|214|Updated Sep 16, 2025
One-click install
npx skills add https://github.com/modu-ai/moai-adk --skill moai-alfred-spec-metadata-validation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: moai-alfred-spec-metadata-validation
Source: https://github.com/modu-ai/moai-adk/tree/main/.claude/skills/moai-alfred-spec-metadata-validation
Command: npx skills add https://github.com/modu-ai/moai-adk --skill moai-alfred-spec-metadata-validation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes examples (resource) and references (resource) components.

What problem does it solve?

Inconsistent or incomplete SPEC (Specification) metadata can hinder project tracking and AI collaboration. This Skill automatically validates the YAML frontmatter of your SPEC documents, ensuring all required fields are present and compliant with project standards, saving you review time.

Core Features & Use Cases

  • Required Field Enforcement: Checks for the mandatory presence of 7 key fields in SPEC YAML frontmatter.
  • HISTORY Section Compliance: Validates the structure and content of the HISTORY section for proper change tracking.
  • Automated Feedback: Provides immediate feedback on metadata errors, guiding you to correct them efficiently.
  • Use Case: Before committing a new SPEC, this Skill can automatically scan its SKILL.md file to ensure it has a name, description, version, created, updated, status, and keywords field, preventing incomplete documentation.

Quick Start

No direct user command needed.

This skill operates automatically when a SPEC is created or modified,

ensuring its metadata is valid and complete.

It helps maintain high-quality project documentation.

Frequently Asked Questions about moai-alfred-spec-metadata-validation

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

FAQPage Schema
How do I validate SPEC metadata for consistency?

Validate SPEC metadata by checking YAML frontmatter for required fields: name, description, version, created, updated, status, and keywords. This Skill automatically scans your SPEC documents and provides immediate feedback on missing or malformed metadata, ensuring compliance with project standards before commit.

What fields are required in SPEC YAML frontmatter?

SPEC YAML frontmatter requires seven mandatory fields: name, description, version, created, updated, status, and keywords. This Skill enforces their presence and validates the HISTORY section structure for proper change tracking, preventing incomplete documentation.

Can I automate SPEC documentation quality checks?

Yes. This Skill operates automatically when a SPEC is created or modified, scanning the SKILL.md file and validating all required metadata fields. It provides automated feedback on errors, guiding you to correct them efficiently without manual review overhead.

How do I ensure SPEC HISTORY sections are properly structured?

SPEC HISTORY section compliance is validated automatically by this Skill, which checks both structure and content for proper change tracking. The validation ensures your HISTORY entries meet project standards and prevents incomplete or malformed change records.

What happens if a SPEC is missing required metadata fields?

When required metadata fields are missing from SPEC YAML frontmatter, this Skill detects the inconsistency and provides immediate feedback identifying which fields are absent. This prevents incomplete SPECs from being committed and maintains high-quality project documentation.