validate-codex-config

Validate afi-config codex, governance artifacts, and schema definitions.

Updated Jun 25, 2025
One-click install
npx skills add https://github.com/AFI-Protocol/afi-config --skill validate-codex-config
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validate-codex-config
Source: https://github.com/AFI-Protocol/afi-config/tree/main/.factory/skills/validate-codex-config
Command: npx skills add https://github.com/AFI-Protocol/afi-config --skill validate-codex-config

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents errors and inconsistencies in critical configuration files and governance artifacts by performing thorough, read-only validation before changes are merged or deployed.

Core Features & Use Cases

  • Comprehensive Validation: Checks syntax, file references, schema compliance, and command execution for configuration files.
  • Metadata Auditing: Verifies the accuracy and consistency of .afi-codex.json metadata against actual repository contents.
  • Use Case: Before merging a pull request that modifies AFI Protocol schemas, use this Skill to ensure all schemas are valid, all internal links within governance documents are unbroken, and that the repository's metadata accurately reflects its capabilities.

Quick Start

Run a full validation of all codex, schema, and governance files in the afi-config repository.

Frequently Asked Questions about validate-codex-config

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

FAQPage Schema
How do I validate codex config files for syntax errors and broken references?

Validate codex config files by running a read-only check for syntax errors, broken file references, and schema compliance. This process inspects governance artifacts and schema definitions to catch inconsistencies early before deployment.

What is the best way to audit .afi-codex.json metadata for accuracy against repository contents?

Auditing .afi-codex.json metadata involves verifying its accuracy and consistency against actual repository contents. A read-only validation check ensures the file metadata correctly reflects the repository's current capabilities and structure.

Can I check schema compliance and test execution success for governance artifacts before merging?

Schema compliance and test execution for governance artifacts are checked by running validation commands like `npm run validate` and `npm test`. This confirms structural integrity and successful execution before you merge configuration changes.

Does config validation modify my repository files during the auditing process?

Config validation performs read-only validation only, meaning it does not modify your repository files. It safely checks for syntax errors, broken references, and schema compliance without altering the original configuration artifacts.

Why should I validate governance artifacts and schema definitions before deployment?

Validating governance artifacts and schema definitions before deployment prevents errors and inconsistencies in critical configuration files. It ensures structural integrity and metadata accuracy, avoiding failures caused by broken references or syntax errors.

What limitations exist when validating afi-config codex and governance files?

Validation of afi-config codex and governance files is limited to read-only checks for syntax, references, and schema compliance. It does not auto-fix errors or execute write operations, requiring manual intervention to resolve detected issues.