config-validator

Validate AIWG YAML/JSON configuration files for syntax, schema, and references.

175|26|Updated Aug 14, 2025
One-click install
npx skills add https://github.com/jmagly/ai-writing-guide --skill config-validator-jmagly
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: config-validator
Source: https://github.com/jmagly/ai-writing-guide/tree/main/.factory/skills/config-validator
Command: npx skills add https://github.com/jmagly/ai-writing-guide --skill config-validator-jmagly

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires project-awareness, artifact-metadata, and includes references (resource) components.

What problem does it solve?

This Skill eliminates configuration errors and setup issues by automatically validating all AIWG configuration files for syntax, schema, and references.

Core Features & Use Cases

  • Configuration Validation: Automatically scans and validates YAML/JSON configuration files against schemas.
  • Automated Fixes: Applies automatic corrections for common configuration issues.

Quick Start

When you say "validate config", this Skill checks all AIWG config files for errors and warnings.

  • Use Case: Imagine you're setting up a new project. Use this Skill to automatically validate your project configuration and generate a detailed report with fix recommendations.

Example Output

"Configuration Validation Complete

Files Checked: 18 Errors: 1 (blocking) Warnings: 3

Critical Issue: ❌ project.yaml: Missing required field 'project_type'

Warnings: ⚠️ team-profile.yaml: Deprecated field 'team_lead'

Quick Fix Available: Run 'config-validator --fix' for automated fixes

Report: .aiwg/reports/config-validation.md"

Frequently Asked Questions about config-validator

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

FAQPage Schema
How do I validate YAML and JSON configuration files automatically?

Configuration validation scans YAML/JSON files against predefined schemas to check syntax, required fields, and structural correctness. This Skill automatically inspects all AIWG config files, reports errors with severity levels, and generates actionable fix recommendations in a single pass.

What configuration errors does this tool catch?

The validator detects syntax errors, missing required fields, schema violations, broken cross-references between configs, and conflicting settings. It categorizes issues by severity—blocking errors versus warnings—and provides specific remediation steps for each problem found.

Can I automatically fix configuration issues instead of manually editing files?

Yes. The Skill applies automatic corrections for common configuration problems when you run it with the fix flag. It resolves syntax issues and fills in standard defaults, then generates a validation report showing what was changed and what requires manual review.

Does this work with AIWG Core, Framework, and Voice configurations?

Configuration validation supports all three AIWG config types—Core, Framework, and Voice. It checks completeness and correctness across all three simultaneously, detecting cross-config conflicts and ensuring your entire project setup is consistent and valid.

When should I run configuration validation in my project workflow?

Run validation after initial setup, before deployment, and whenever you modify config files. It works at any project phase—during early configuration, before moving to production, or when troubleshooting unexpected behavior caused by config drift or incomplete settings.

What output does the validation report include?

The report lists all files checked, counts of errors and warnings by severity, shows each issue with file location and field name, provides context about why it's a problem, and includes recommended fixes. Results export as a detailed markdown report for team review and documentation.