audit-plugin

Validate Claude Code plugin structure and compliance with repository standards.

5|3|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/richfrem/agent-plugins-skills --skill audit-plugin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-plugin
Source: https://github.com/richfrem/agent-plugins-skills/tree/main/plugins/agent-scaffolders/skills/audit-plugin
Command: npx skills add https://github.com/richfrem/agent-plugins-skills --skill audit-plugin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates Claude Code plugins against structure standards, ensures required fields exist, and identifies misconfigurations that could prevent plugins from loading.

Core Features & Use Cases

  • Validate manifest and plugin.json for required fields, naming conventions, and compliance.
  • Check directory structure: root-level components must be at the project root (not inside .claude-plugin/).
  • Validate commands/agents/skills/hooks: frontmatter presence and required fields, plus basic integrity checks.
  • Run security and quality checks, producing a report with actionable remediation guidance.
  • Suitable for audit-before-release workflows and proactive quality reviews after plugin changes.

Quick Start

Run the audit against your plugin directory to generate a full validation report.

Frequently Asked Questions about audit-plugin

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

FAQPage Schema
How do I validate my Claude Code plugin structure for manifest correctness?

To validate Claude Code plugin structure, run an audit to examine manifest correctness, component placement, and required fields in plugin.json. It generates a full report confirming root-level components are at the project root.

What does a plugin compliance audit check for in commands, agents, and skills?

A plugin compliance audit checks commands, agents, skills, and hooks for frontmatter presence, required fields, and basic integrity. It parses frontmatter and runs JSON checks to ensure formatting conforms to repository standards.

Why is my Claude Code plugin not loading due to misconfiguration?

Claude Code plugins fail to load due to misconfiguration when required fields are missing or directory structure is incorrect. An audit identifies these issues by validating the manifest and checking component placement.

Can I run security and quality checks on my plugin before release?

Yes, you can run security and quality checks on your plugin before release. The audit examines security considerations across components and produces a report with actionable remediation guidance.

When should I run a plugin validation audit during development?

Run a plugin validation audit during audit-before-release workflows and as a proactive quality review after making plugin changes. This ensures formatting conforms to guidelines and identifies misconfigurations early.