codex-oi

Project overview

skill-validator is a CLI for checking Agent Skill packages beyond basic specification compliance. It validates structure and frontmatter, detects broken or orphaned references, flags unnecessary files, reports token usage, and analyzes instruction density and cross-language contamination. Optional model-based evaluation can score dimensions such as clarity, actionability, and novelty. The tool can be installed through Homebrew or Go, used as a pre-commit check, integrated into CI, or imported as a Go library for custom validation workflows.

Project overview

Install it in a project to generate agent instructions, reusable skills, a dependency graph, and Git hooks for tools such as Claude Code, Cursor, and Gemini. The setup helps agents answer structural questions and enforces rules around commits, file headers, and complexity; in-agent skills need no separate API key, while standalone CLI features may require one.