Workshop Creator

The Workshop Creator skill manages the creation of training workshops for the Factory. Workshops are comprehensive guides that teach specific concepts, technologies, or workflows. They reside in docs/workshops/.

Standard Structure

Workshops are Markdown files following a specific naming convention (LX_name.md) and containing:

1. Level (LX): Incremental difficulty.
2. Learning Objectives: What the user will learn.
3. Core Content: Detailed instructions and code examples.
4. Practice: Hands-on exercises.

Process

1. Syllabus: Define the learning path.
2. Draft: Write the workshop in Markdown.
3. Validate: Run scripts/quick_validate.py to ensure naming and section compliance.

When to Use

• When creating a new workshop from scratch
• When improving or refactoring an existing workshop
• When standardizing an workshop to adhere to Factory schemas
• When another skill or agent requests a compliant workshop

Prerequisites

• Access to the Factory schemas in schemas/
• Understanding of the artifact structure defined in this skill
• The quick_validate.py script must be available for schema validation

Best Practices

• Always validate against the schema before finalizing
• Keep the artifact focused and non-redundant with existing ones
• Follow the naming conventions defined in the Factory standards
• Document the artifact's purpose clearly in the description field
• Link related artifacts in the related_skills or related_knowledge fields