skill-governance

Audit skill directory layouts and validate SKILL.md contract headings.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/graysurf/agent-kit --skill skill-governance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-governance
Source: https://github.com/graysurf/agent-kit/tree/main/skills/tools/skill-management/skill-governance
Command: npx skills add https://github.com/graysurf/agent-kit --skill skill-governance

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill ensures that your AI skills are well-structured, correctly defined, and adhere to established contracts, preventing errors and improving maintainability.

Core Features & Use Cases

  • Skill Layout Auditing: Verifies that skill directories contain only allowed top-level entries.
  • Contract Validation: Checks SKILL.md files for required headings (Prereqs, Inputs, Outputs, Exit codes, Failure modes) in the correct order.
  • Use Case: Before merging a new skill into the main repository, run this skill to automatically check its structure and SKILL.md contract for compliance, catching potential issues early.

Quick Start

Run the skill-governance skill to audit the layout of the skill located at 'skills/tools/my-new-skill/'.

Frequently Asked Questions about skill-governance

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

FAQPage Schema
How do I validate the SKILL.md contract for an AI skill?

To validate a SKILL.md contract, audit the file to ensure required headings like Prereqs, Inputs, Outputs, Exit codes, and Failure modes are present and ordered correctly within the Contract section.

What is skill layout auditing and why is it needed?

Skill layout auditing verifies that skill directories contain only allowed top-level entries. It is needed to ensure AI skills are well-structured, correctly defined, and adhere to established contracts, preventing errors and improving maintainability.

How do I check the directory structure of all tracked skills in a Git repository?

You can check the directory structure of all tracked skills in a Git repository by running a governance validation script that automatically audits top-level entries and enforces contract compliance across the entire repository.

Do I need any external dependencies to audit skill directory layouts?

No external dependencies are required to audit skill directory layouts and validate contracts. The skill operates independently using its internal scripts and references to enforce structure and compliance rules.

Can I validate an individual skill file instead of the entire repository?

Yes, you can validate an individual skill file instead of the entire repository. The governance validation supports checking specific skill directories to catch potential structural or contract issues early before merging.

What happens if required headings are missing from the Contract section?

If required headings are missing from the Contract section, the validation audit will fail. This mechanism catches potential issues early by ensuring every SKILL.md file strictly adheres to the established directory layout and contract rules.