Claude Code Plugin Conventions Reference

Purpose: This skill is the single source of truth for Claude Code artifact conventions. Audit commands inject this content into Codex's developer-instructions so Codex can accurately validate Claude Code artifacts despite having no native knowledge of the platform.

Freshness: Last updated 2026-03-25 from context7 (/websites/code_claude_en_plugins-reference, /websites/code_claude_en_plugins). Run /cc-suite:refresh-knowledge to refresh.

When to Use

Load this skill when:

• Auditing Claude Code plugin artifacts (commands, agents, skills, hooks, plugin.json)
• Validating frontmatter fields against the official schema
• Checking hook event names, types, and output formats
• Authoring new plugin artifacts and need the canonical field reference
• Running /cc-suite:audit-plugin, /cc-suite:audit-command, /cc-suite:audit-agent, or /cc-suite:audit-skill

plugin.json Schema

Only name is strictly required. Version and description are strongly recommended but optional.