validate

Validate workflow Markdown documents against the required format contract.

4|Updated Mar 23, 2025

Search Tags:#workflow #markdown #validation #validate #lint #contract #ci

Ready to run

npx skills add https://github.com/matochu/pythia --skill validate-matochu

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: validate
Source: https://github.com/matochu/pythia/tree/main/.agents/skills/validate
Command: npx skills add https://github.com/matochu/pythia --skill validate-matochu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill validates workflow Markdown documents against the documented format contract, ensuring consistency across plans, reviews, implementation reports, and audits.

Core Features & Use Cases

Enforces normative formats for plan, review, implementation, and audit documents.
Validates that Markdown workflow files conform to the contract and reports mismatches with actionable feedback.
Integrates with Validator subagents and CI workflows to guard documentation quality.

Quick Start

Run the workflow-doc validator on a target Markdown file from the repository root using the scripts/validate-workflow-doc.sh script.

Frequently Asked Questions about validate

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

FAQPage Schema

How do I validate workflow Markdown documents against a format contract?▼

To validate workflow Markdown documents, run the validation script from the repository root to enforce the format contract on plans, reviews, and audits. The validator checks Markdown files for conformance and reports mismatches with actionable diagnostic feedback.

What is Markdown validation for CI workflows?▼

Markdown validation for CI workflows ensures documentation consistency by enforcing hard rules and normative formats on plan, review, implementation, and audit files. It guards documentation quality by delivering exit codes and diagnostic output for non-conforming files.

Can I integrate Markdown linting into my CI pipeline?▼

Yes, you can integrate this Markdown linting into your CI pipeline using the validation script and Validator subagents. It applies to CI validation workflows to enforce the format contract and automatically guard documentation quality across releases.

Does the workflow document validator support human review processes?▼

Yes, the workflow document validator supports human review processes by ensuring implementation reports and plans meet the required format contract. It provides diagnostic output that helps human reviewers quickly identify and fix formatting mismatches.

What diagnostic output do I get for non-conforming Markdown files?▼

For non-conforming Markdown files, the validator delivers exit codes and diagnostic output that identify specific contract violations. This actionable feedback highlights exactly where plans, reviews, or audits fail to meet the normative format requirements.