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
1---2name: competition-organizer-docs3description: 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.4---5
6# Competition Organizer Documentation Skill
7
8Generates Diataxis-compliant documentation for WODsmith competition organizers.
9
10## Persona: Competition Organizer
11
12**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).
13
14**Documentation needs by experience:**
15
16| Level | Primary Need | Doc Types |
17|-------|--------------|-----------|
18| First-time | "How do I even start?" | Tutorials |
19| Experienced | "How do I do X efficiently?" | How-to guides |
20| Power user | "What are the exact options?" | Reference |
21
22## Critical Workflow
23
24**REQUIRED**: Before writing organizer docs:
25
261. Load the base skill: `skills_use(name="documentation")`
272. Read the relevant Diataxis reference from `documentation/references/`
283. Load the workflow reference below for organizer-specific details
294. Apply both Diataxis principles AND organizer context
30
31## Workflow References (load on demand)
32
33**REQUIRED**: Before writing docs, load the relevant reference:
34
35| If documenting... | Load this reference |
36|-------------------|---------------------|
37| Create, Edit, Settings, Delete competition | `references/competition-setup.md` |
38| Registrations, Divisions, Pricing, Athletes | `references/athlete-management.md` |
39| Events, Schedule, Heats, Results, Scoring | `references/event-operations.md` |
40| Volunteers, Judges, Rotations | `references/volunteer-coordination.md` |
41| Revenue, Sponsors, Series | `references/business-operations.md` |
42
43## Workflow Overview
44
45### Tutorials (4 workflows)
46- Create Competition, Configure Divisions, Configure Registration, Add First Event
47
48### How-to Guides (13 workflows)
49- 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
50
51### Reference (6 topics)
52- Event Types, Division Configuration, Registration Fields, Schedule API, Scoring Rules, Permissions
53
54### Explanation (4 topics)
55- Scoring System, Judge Rotations, Heat Scheduling, Division Structure
56
57## User Journeys
58
59**Journey 1: First-Time Organizer** (11 steps)
60Create competition → Set divisions → Add events → Configure scoring → Set pricing → Open registration → Process registrations → Schedule heats → Recruit volunteers → Event day ops → Publish results
61
62**Journey 2: Event Day Operations**
63Check-in athletes → Assign heats → Enter results → Handle disputes → Publish live scores
64
65**Journey 3: Post-Competition**
66Finalize results → Export data → Track revenue → Thank sponsors → Archive competition
67
68## Structured Output Templates
69
70```yaml
71# Documentation request
72type: documentation-request
73persona: organizer
74workflow: <workflow-name>
75doc_type: tutorial | how-to | reference | explanation
76context:
77 route: <route-path>
78 complexity: low | medium | high | very-high
79```
majiayu000