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:

1. Load the base skill: skills_use(name="documentation")
2. Read the relevant Diataxis reference from documentation/references/
3. Load the workflow reference below for organizer-specific details
4. 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