skill-auditor

Audit skill definitions for compliance and quality across the repository.

3|2|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/cloga/optimus-code --skill skill-auditor-cloga
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-auditor
Source: https://github.com/cloga/optimus-code/tree/main/optimus-plugin/skills/skill-auditor
Command: npx skills add https://github.com/cloga/optimus-code --skill skill-auditor-cloga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits new or modified skills for Optimus compliance before deployment, ensuring proper structure, accurate frontmatter, and valid MCP tool usage.

Core Features & Use Cases

  • Validates that each skill lives under .optimus/skills/<name>/SKILL.md with correct lowercase, hyphenated directory name matching the frontmatter name.
  • Checks YAML frontmatter for required fields (name and description) and quality guidelines.
  • Verifies MCP tool references are valid and present in the MCP server.

Quick Start

Run the audit against a skill directory to generate a compliance report and suggested fixes.

Frequently Asked Questions about skill-auditor

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

FAQPage Schema
How do I validate Optimus skill definitions for compliance?▼

To validate Optimus skill definitions, run an audit against the skill directory to check structure and frontmatter, generating a structured compliance report with actionable fixes and severity levels.

What does a skill directory structure audit check?▼

A skill directory structure audit verifies that each skill lives under .optimus/skills/<name>/SKILL.md with a correct lowercase, hyphenated directory name matching the YAML frontmatter name.

How do I lint YAML frontmatter for Optimus skills?▼

To lint YAML frontmatter for Optimus skills, run the audit to check for required fields like name and description, ensuring they meet quality guidelines before deployment.

How do I verify MCP tool usage in skill definitions?▼

To verify MCP tool usage in skill definitions, run the audit to confirm that MCP tool references are valid and present in the MCP server, producing a report of any invalid usage.

Can I get suggested fixes for skill quality issues?▼

You can get suggested fixes for skill quality issues by running the audit, which produces a structured report containing actionable fixes and severity levels to guide improvements.