claude-code-conventions

Reference Claude Code plugin artifact conventions for audits and development prompts.

29|4|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/xiaolai/codex-toolkit-for-claude --skill claude-code-conventions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-code-conventions
Source: https://github.com/xiaolai/codex-toolkit-for-claude/tree/main/skills/codex-toolkit/claude-code-conventions
Command: npx skills add https://github.com/xiaolai/codex-toolkit-for-claude --skill claude-code-conventions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Canonical reference for Claude Code plugin artifact conventions to guide audits and development prompts.

Core Features & Use Cases

  • Canonical reference for artifact schemas, hook events, and frontmatter fields used by Codex audits
  • Ensures knowledge is loaded into Codex context and stays up-to-date via refresh
  • Supports integration into auditing workflows for plugin development and marketplace validation

Quick Start

Run the knowledge refresh to pull the latest Claude Code conventions into your context.

Frequently Asked Questions about claude-code-conventions

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

FAQPage Schema
What are the required frontmatter fields for a Claude Code plugin SKILL.md?

The required frontmatter fields for a SKILL.md are name and description, which must be present to pass Claude Code plugin audits and enable consistent artifact schema validation.

How do I structure plugin artifacts for Claude Code audits?

Structure plugin artifacts by grouping supporting materials under references/, examples/, and scripts/ directories so content can be correctly loaded into Codex context during automated checks.

How do Claude Code hook events work during plugin validation?

Claude Code hook events define specific plugin lifecycle triggers that are evaluated during automated audits to ensure correct interpretation of plugin.json schemas and naming rules.

Can I use optional frontmatter fields like version and globs in SKILL.md?

Yes, version and globs are optional frontmatter fields in SKILL.md, allowing you to specify plugin versioning and file matching patterns alongside the mandatory name and description fields.

How do I load updated Claude Code conventions into Codex context?

Run the knowledge refresh workflow to pull the latest Claude Code plugin conventions into Codex context, ensuring your artifact schemas and hook events stay current for automated auditing.

Why do my Claude Code plugin audits fail during schema validation?

Claude Code plugin audits fail when SKILL.md frontmatter is missing required name or description fields, or when supporting artifacts are not properly grouped under references/, examples/, and scripts/ directories.