audit

Audits skill directories for spec compliance and structural correctness.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/mistakeknot/interskill --skill audit-mistakeknot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit
Source: https://github.com/mistakeknot/interskill/tree/main/skills/audit
Command: npx skills add https://github.com/mistakeknot/interskill --skill audit-mistakeknot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams verify that a skill directory complies with the official specification, ensuring correct structure, frontmatter, and invocation controls before deployment.

Core Features & Use Cases

  • Validates YAML frontmatter presence and correctness, including required name and description fields.
  • Checks that SKILL.md exists at the root and that references are one level deep.
  • Detects anti-patterns and quality gaps to prevent faulty skills from being published.

Quick Start

Run the audit against a skill directory to generate a structured report.

Frequently Asked Questions about audit

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

FAQPage Schema
How do I validate YAML frontmatter in skill directories before deployment?

To validate YAML frontmatter in skill directories, run an audit to verify required name and description fields exist and check SKILL.md presence, producing a structured report for corrective action.

What is the best way to check skills for anti-patterns and quality gaps?

Checking skills for anti-patterns involves auditing the directory against the official spec to detect structural flaws, validate one-level references, and flag quality gaps to prevent faulty skills from being published.

Can I use an automated audit to verify skill structure across multiple repositories?

Yes, an automated audit applies to new and existing skills across repositories and deployment pipelines to verify structure, frontmatter validity, and invocation controls before publication.

Why does my skill fail the spec compliance check during deployment?

Your skill fails spec compliance checks when the audit detects missing YAML frontmatter fields, absent SKILL.md at the root, invalid one-level references, or known anti-patterns requiring corrective action.

What does a skill audit check for in SKILL.md and invocation controls?

A skill audit checks for SKILL.md presence at the root, validates that references are exactly one level deep, and enforces invocation controls to ensure alignment with official specifications.