validate-brief

Validate site-brief JSON files against a schema and report invalid fields.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/calebaero/website-factory --skill validate-brief
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validate-brief
Source: https://github.com/calebaero/website-factory/tree/main/skills/validate-brief
Command: npx skills add https://github.com/calebaero/website-factory --skill validate-brief

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates a site-brief against schemas/site-brief.schema.json and reports every field that is missing, malformed, or outside its enum.

Core Features & Use Cases

  • Validates required and optional fields in a site-brief.json, including business information, target audience, and design constraints.
  • Reports issues clearly with field-level detail and suggested fixes to restore validity.
  • Supports optional safe auto-fixes for whitespace, slug formatting, hex colors, and default values, when requested.

Quick Start

Validate a site-brief against the schema, run checks, and output results in both human-readable and JSON formats.

Frequently Asked Questions about validate-brief

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

FAQPage Schema
How do I validate a JSON site brief against a schema?

To validate a JSON site brief, this Skill checks it against schemas/site-brief.schema.json and reports every field that is missing, malformed, or outside its enum with field-level detail.

What is a site brief schema validation report?

A site brief schema validation report identifies every missing, malformed, or invalid enum field in your JSON file. This Skill generates the report in both human-readable and JSON formats on request.

Can I automatically fix malformed JSON fields during brief validation?

Yes, you can automatically fix malformed JSON fields during brief validation by using the --fix option to safely apply corrections for whitespace, slug formatting, hex colors, and default values.

Does the brief validation auto-fix modify my entire JSON file?

No, the brief validation auto-fix does not modify your entire JSON file. It only applies explicit, safe fixes to whitespace, slugs, hex colors, and defaults without altering the brief beyond those.

What is the best way to lint a site brief for missing business information?

The best way to lint a site brief for missing business information is to validate it against the site-brief schema, which checks required and optional fields including target audience and design constraints.