example-skill

Frontmatter defines metadata for Claude Code skills, including name, description, trigger patterns, and tool restrictions. This Skill demonstrates the exact SKILL.md layout with required fields like description and allowed-tools, ensuring your skill is discoverable and properly configured for the Claude Code environment.

Copy the example skill structure in this directory and adapt the frontmatter and content to your use case. Start by defining your skill's name, description with trigger guidance, core task, and any tool restrictions, then build out the implementation following the demonstrated best practices.

Skills are reusable, task-focused plugins with frontmatter metadata and trigger descriptions; commands are single-purpose CLI operations; agents are autonomous decision-making systems. This Skill clarifies these distinctions and guides you toward choosing the right plugin type for your use case.

Required frontmatter fields include name, description, and tool restrictions (allowed-tools). The description should contain trigger patterns and when-to-use guidance so Claude Code can route user requests correctly and users understand when to invoke your skill.

Define tool restrictions in the skill's frontmatter using the allowed-tools field. This pattern ensures your skill only accesses necessary tools, improving security and preventing unintended side effects when the skill is invoked.