gitwalter 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:
- Level (LX): Incremental difficulty.
- Learning Objectives: What the user will learn.
- Core Content: Detailed instructions and code examples.
- Practice: Hands-on exercises.
Process
- Syllabus: Define the learning path.
- Draft: Write the workshop in Markdown.
- Validate: Run
scripts/quick_validate.pyto 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.pyscript 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_skillsorrelated_knowledgefields