competition-organizer-docs
Generate and review documentation for competition organizers using Diataxis framework. Use when writing docs for organizer workflows like creating competitions, managing divisions, scheduling heats, handling registrations, entering results, or managing volunteers/judges.
When & Why to Use This Skill
This Claude skill automates the creation of professional, Diataxis-compliant documentation tailored specifically for competition organizers. By leveraging the Diataxis framework, it helps event directors and gym owners generate structured tutorials, how-to guides, and technical references for complex workflows like athlete registration, heat scheduling, and result management, ensuring clear and actionable instructions for every stage of an event.
Use Cases
- Case 1: Creating step-by-step onboarding tutorials for first-time organizers to set up their first competition and configure athlete divisions.
- Case 2: Generating detailed how-to guides for experienced staff on managing judge rotations and entering live results during high-pressure event days.
- Case 3: Developing comprehensive reference documentation for scoring rules and registration field configurations to assist power users and developers.
- Case 4: Drafting clear conceptual explanations of complex systems like heat scheduling logic and division structures for stakeholder transparency.
| name | competition-organizer-docs |
|---|---|
| description | Generate and review documentation for competition organizers using Diataxis framework. Use when writing docs for organizer workflows like creating competitions, managing divisions, scheduling heats, handling registrations, entering results, or managing volunteers/judges. |
Competition Organizer Documentation Skill
Generates Diataxis-compliant documentation for WODsmith competition organizers.
Persona: Competition Organizer
Who they are: CrossFit gym owners, event directors, competition coordinators. Time-constrained, varying technical comfort, may run 1-2 events/year (casual) or 10+ (professional).
Documentation needs by experience:
| Level | Primary Need | Doc Types |
|---|---|---|
| First-time | "How do I even start?" | Tutorials |
| Experienced | "How do I do X efficiently?" | How-to guides |
| Power user | "What are the exact options?" | Reference |
Critical Workflow
REQUIRED: Before writing organizer docs:
- Load the base skill:
skills_use(name="documentation") - Read the relevant Diataxis reference from
documentation/references/ - Load the workflow reference below for organizer-specific details
- Apply both Diataxis principles AND organizer context
Workflow References (load on demand)
REQUIRED: Before writing docs, load the relevant reference:
| If documenting... | Load this reference |
|---|---|
| Create, Edit, Settings, Delete competition | references/competition-setup.md |
| Registrations, Divisions, Pricing, Athletes | references/athlete-management.md |
| Events, Schedule, Heats, Results, Scoring | references/event-operations.md |
| Volunteers, Judges, Rotations | references/volunteer-coordination.md |
| Revenue, Sponsors, Series | references/business-operations.md |
Workflow Overview
Tutorials (4 workflows)
- Create Competition, Configure Divisions, Configure Registration, Add First Event
How-to Guides (13 workflows)
- Schedule Heats, Manage Registrations, Volunteers, Judge Rotations, Enter Results, Track Revenue, Manage Sponsors, Competition Series, Edit Competition, Settings, Delete Competition, Assign Athletes to Heats, Configure Scoring
Reference (6 topics)
- Event Types, Division Configuration, Registration Fields, Schedule API, Scoring Rules, Permissions
Explanation (4 topics)
- Scoring System, Judge Rotations, Heat Scheduling, Division Structure
User Journeys
Journey 1: First-Time Organizer (11 steps) Create competition → Set divisions → Add events → Configure scoring → Set pricing → Open registration → Process registrations → Schedule heats → Recruit volunteers → Event day ops → Publish results
Journey 2: Event Day Operations Check-in athletes → Assign heats → Enter results → Handle disputes → Publish live scores
Journey 3: Post-Competition Finalize results → Export data → Track revenue → Thank sponsors → Archive competition
Structured Output Templates
# Documentation request
type: documentation-request
persona: organizer
workflow: <workflow-name>
doc_type: tutorial | how-to | reference | explanation
context:
route: <route-path>
complexity: low | medium | high | very-high