validation-repair

Repair DocMason knowledge base validation failures and rerun validation until valid.

135|36|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/JetXu-LLM/DocMason --skill validation-repair
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validation-repair
Source: https://github.com/JetXu-LLM/DocMason/tree/main/skills/canonical/validation-repair
Command: npx skills add https://github.com/JetXu-LLM/DocMason --skill validation-repair

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the detection and repair of validation blockers in the DocMason knowledge base, ensuring content integrity and readiness for publication.

Core Features & Use Cases

  • Detects missing or malformed validation artifacts (knowledge.json, summary.md, citations) in staged sources and applies fixes.
  • Repeats docmason validate-kb --json until the result is valid or returns warnings to unblock publication.
  • Coordinates with existing knowledge-base workflows to ensure provenance is preserved and related sources are correctly linked.

Quick Start

Invoke this skill to repair staged validation issues in the knowledge base and re-run validation until a valid or warning state is reached.

Frequently Asked Questions about validation-repair

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

FAQPage Schema
How do I fix DocMason knowledge base validation errors before publishing?

To fix DocMason knowledge base validation errors, you can run a repair process that detects missing or malformed artifacts like knowledge.json and summary.md, then re-runs validation until publication is unblocked.

What causes unresolved citations and invalid artifact references during staging?

Unresolved citations and invalid artifact references during staging are caused by missing or malformed validation artifacts in the staged sources, which must be detected and corrected to preserve provenance.

How do I automate running docmason validate-kb --json until the knowledge base is valid?

You can automate the docmason validate-kb --json command by applying a repair workflow that repeatedly executes validation, applies fixes, and checks outputs until a valid or warning state is reached.

Does repairing knowledge base validation blockers require local file access?

Yes, repairing knowledge base validation blockers requires local file access, shell or command execution, and the ability to inspect machine-readable validation output to apply fixes to staged sources.

Why does my staged knowledge base fail validation when provenance is linked?

A staged knowledge base fails validation when provenance is linked if validation reports are missing or malformed, requiring automated repair to ensure related sources are correctly resolved before publication.