codex-skill-audit

Audit Codex skill repositories for structure, frontmatter, and governance readiness.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/oozoofrog/codex-skills-project --skill codex-skill-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codex-skill-audit
Source: https://github.com/oozoofrog/codex-skills-project/tree/main/.agents/skills/codex-skill-audit
Command: npx skills add https://github.com/oozoofrog/codex-skills-project --skill codex-skill-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Audits Codex skill repositories for structure, frontmatter quality, and governance readiness.

Core Features & Use Cases

  • Deterministic repo audit: finds missing frontmatter, kebab-case violations, and structural gaps across all skills under .agents/skills.
  • Review harness validation: verifies Review Harness sections, axes, and actions to ensure governance and reproducible evaluation.
  • Evidence-driven reporting: aggregates findings, strengths, and machine-readable summaries for automated dashboards and audits.

Quick Start

Run the deterministic audit against the target repository to generate a comprehensive report.

Frequently Asked Questions about codex-skill-audit

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

FAQPage Schema
How do I audit a Codex skill repository for structure and frontmatter quality?

To audit a Codex skill repository for structure and frontmatter quality, run the deterministic scripts to scan the .agents/skills tree for missing frontmatter, kebab-case violations, and long SKILL.md bodies, generating both human-readable and machine-readable summaries.

What is repository structure health for Codex skills and why does it matter?

Repository structure health for Codex skills ensures governance readiness by verifying that frontmatter, kebab-case naming, and operator sections meet standards. Maintaining these standards prevents structural gaps and ensures reproducible evaluation across the entire skills tree.

Can I validate Review Harness configuration and sections automatically across a skills repo?

Yes, you can validate Review Harness configuration automatically. The audit verifies Review Harness sections, axes, and actions across the repository to ensure governance and reproducible evaluation are correctly configured.

How do I check for missing frontmatter and kebab-case violations in skill directories?

You can check for missing frontmatter and kebab-case violations by running the deterministic audit scripts against the target repository. The scripts detect these structural gaps across all skills under the .agents/skills directory and report them in the findings.

Does the audit generate a machine-readable summary for automated dashboards?

Yes, the audit generates a machine-readable summary for automated dashboards. It aggregates evidence-driven findings, strengths, and structural gaps into outputs suitable for automated pipelines and governance reporting.

What are the limitations of deterministic repository audits for skill governance readiness?

Deterministic repository audits for skill governance readiness are limited to detecting structural gaps, frontmatter quality, and Review Harness configuration. They do not evaluate the semantic logic or runtime behavior of the skills within the .agents/skills tree.