codex-validation

Validate consistency between canonical _codex and project references in Brainbase.

9|Updated Nov 22, 2025
One-click install
npx skills add https://github.com/Unson-LLC/brainbase --skill codex-validation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codex-validation
Source: https://github.com/Unson-LLC/brainbase/tree/main/.claude/skills/codex-validation
Command: npx skills add https://github.com/Unson-LLC/brainbase --skill codex-validation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Brainbase's canonical _codex and project-side references sometimes drift, causing broken links, mis-edits, and missing required sections. This skill validates and enforces alignment to preserve the single source of truth.

Core Features & Use Cases

  • Link integrity checks: scans project docs to ensure they reference the correct _codex content.
  • Edit consistency validation: flags project files that contain actual content instead of simple references.
  • Compliance verification: confirms required sections exist in canonical documents and that projects stay synchronized across repositories.

Quick Start

Run the codex-validation skill on a sample project to detect broken links and mis-edits, then apply fixes in the appropriate _codex and project files.

Frequently Asked Questions about codex-validation

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

FAQPage Schema
How do I check for broken links between project docs and canonical files?

To check for broken links, you can validate the consistency between project documentation and canonical files. This process scans project docs to ensure they correctly reference the canonical source, detecting broken links and mis-directed references.

What is the best way to maintain documentation consistency across multiple repositories?

The best way to maintain documentation consistency is enforcing a single source of truth where edits occur only in canonical files. This validates that project docs reference those canonical files and flags any mis-edits or missing mandatory sections across repositories.

Why does my project documentation drift from the canonical source files?

Project documentation drifts from the canonical source when project files contain actual content instead of simple references. This mis-edit behavior breaks the single source of truth principle and causes synchronization issues across repositories.

How do I validate that required sections exist in canonical documents?

You can validate that required sections exist in canonical documents by running a compliance verification process. This checks that mandatory sections are present in the canonical files and confirms that all project references stay synchronized.

Can I use this to standardize documentation across multiple projects?

Yes, you can use this to standardize documentation across multiple projects. It applies to repository maintenance by enforcing the principle that edits occur only in canonical files and that project docs correctly reference those canonical sources.