example-skill

Creating a skill in the skills registry requires duplicating the template directory, renaming it, updating plugin.json with your skill's name and description, populating SKILL.md with your documentation, and running the validation script. This ensures your skill meets the registry's structural and metadata standards.

Skill discovery requires mandatory `name` and `description` fields in your frontmatter. These fields enable automatic indexing in the registry. The example-skill demonstrates the complete frontmatter scaffold needed for any new skill to be discoverable.

Run the validation script `python3 scripts/validate_plugins.py` after updating your SKILL.md and plugin.json. This checks that your skill meets all structural requirements and produces a standards-compliant plugin package ready for the registry.

SKILL.md should document your learnings, implementation details, and failed attempts to ensure reproducibility and effective onboarding. This transparency helps future contributors understand design decisions and troubleshoot issues when using or extending your skill.

Yes. The template provides a complete directory structure and SKILL.md scaffold that walks contributors through copying, renaming, and validating skills. It serves as a reference implementation, reducing setup friction for new skill authors across plugin projects.