example-skill

To create a Claude Code plugin skill, start with a root SKILL.md file containing YAML frontmatter with at least the name and description fields, then add your specific trigger conditions and instructions in the body. You can also include optional subdirectories like references or scripts for richer authoring.

The required format for a SKILL.md file includes YAML frontmatter with at least the name and description fields. The description should define trigger phrases or keywords for reliable skill invocation, followed by the body containing your operational instructions.

To write activation descriptions for Claude Code skills, define trigger phrases and keywords directly in the frontmatter description field. This ensures reliable invocation when users ask questions that match the skill's intended operational scope.

Yes, you can add optional subdirectories like references or scripts to a Claude Code skill folder. These supporting resources help manage complex domains and provide examples while keeping the main SKILL.md focused on core activation logic.

The best way to structure a Claude Code skill for discoverability is using a root SKILL.md entry point with clear YAML frontmatter, an activation-oriented description with trigger phrases, and a recommended folder layout with optional supporting subdirectories for complex domains.