skill-creator

To create a Claude Code plugin skill, structure your project with a lean SKILL.md file, a scripts directory for executable code, a references folder for supporting documentation, and an assets directory. This modular structure ensures your AI agent capabilities are discoverable and efficient.

The correct structure for a Claude Code skill includes a primary SKILL.md file with proper frontmatter, alongside scripts, references, and assets directories. Organizing skill content progressively in these directories allows the AI agent to load modular documentation and capabilities efficiently.

Best practices for writing SKILL.md files include using an imperative writing style, describing the skill in the third person, applying progressive disclosure for content organization, and keeping the SKILL.md file lean. These practices ensure the skill remains modular and user-friendly for the AI agent.

You validate AI agent skills by running them through a quality standards checklist that checks for proper file structure, correct frontmatter formatting, imperative writing style, and appropriate content organization. This validation process ensures your skills meet the required benchmarks for discoverability and efficiency.

Yes, you should use third-person descriptions and imperative writing styles for Claude Code plugins. This specific writing approach ensures that the skill instructions are direct, actionable, and easily interpreted by the AI agent during execution.

You need to use progressive disclosure in skill development when a skill requires extensive supporting documentation or scripts that would otherwise overwhelm the main SKILL.md file. This technique keeps the primary file lean while allowing the AI agent to access deeper references as needed.