--- name: "intermediate-example" description: "An intermediate example with metadata and examples" version: "1.2.0" author: "Example Author" created: "2025-01-15" updated: "2025-10-23" category: "examples" tags: ["example", "tutorial", "intermediate"] complexity: "intermediate" has_examples: true example_files: ["examples/demo.py"] when_to_use: - "When learning how to structure skills with metadata" - "When you need examples to reference" --- # Intermediate Example Skill This skill demonstrates more comprehensive metadata usage and includes example files in an `examples/` subdirectory. ## Features - **Version tracking**: Semantic versioning - **Authorship**: Author and date information - **Categorization**: Tags and category for organization - **Complexity**: Indicates skill difficulty level - **Examples**: Reference example files in the skill folder ## Folder Structure ``` intermediate-example/ ├── SKILL.md ← This file └── examples/ ← Optional examples folder └── demo.py ← Example Python script ``` ## Metadata Fields ### Required - `name`: Unique identifier - `description`: Brief description ### Optional (shown in this skill) - `version`: Semantic version - `author`: Skill creator - `created`, `updated`: ISO dates - `category`: Main category - `tags`: List of tags for searching - `complexity`: beginner, intermediate, or advanced - `has_examples`: Boolean flag - `example_files`: Paths relative to skill folder ## Using Examples The `examples/demo.py` file shows a simple Python script that demonstrates the concept. You can reference these files in your skill documentation. ## Best Practices 1. **Use semantic versioning** for the version field 2. **Keep tags relevant** and lowercase 3. **Set appropriate complexity** to help users find suitable skills 4. **List all example files** in the frontmatter 5. **Organize examples** in subdirectories ## Next Steps Check out the `advanced-example` skill for even more metadata fields and a more complex folder structure with templates!