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.