Agent SkillsAgent Skills
wodsmith

athlete-docs

@wodsmith/athlete-docs
wodsmith
1
2 forks
Updated 4/6/2026
View on GitHub

Documentation guidance for competition athletes and volunteers in WODsmith. Use when writing, reviewing, or improving athlete-facing documentation including registration, scheduling, workout viewing, leaderboards, check-in, and volunteer coordination.

Installation

$npx agent-skills-cli install @wodsmith/athlete-docs
Claude Code
Cursor
Copilot
Codex
Antigravity

Details

Path.claude/skills/athlete-docs/SKILL.md
Branchmain
Scoped Name@wodsmith/athlete-docs

Usage

After installing, this skill will be available to your AI coding assistant.

Verify installation:

npx agent-skills-cli list

Skill Instructions


name: athlete-docs description: Documentation guidance for competition athletes and volunteers in WODsmith. Use when writing, reviewing, or improving athlete-facing documentation including registration, scheduling, workout viewing, leaderboards, check-in, and volunteer coordination.

Athlete Documentation Skill

Documentation guidance for the athlete persona in WODsmith competition platform.

Athlete Persona

Who they are: CrossFit athletes registering for and participating in competitions, and volunteers helping at events.

Key differences from organizers:

AspectAthletesOrganizers
InteractionConsumer (read-heavy)Producer (write-heavy)
ComplexitySimple workflowsComplex multi-step setup
DiscoveryHigh (browsing, exploring)Low (knows what they need)

Critical Workflow

REQUIRED: Before writing athlete docs:

  1. Load the parent skill: skills_use(name="documentation")
  2. Apply the Diataxis compass from that skill
  3. Load the workflow reference below for athlete-specific guidance

Workflow References (load on demand)

REQUIRED: Before writing docs, load the relevant reference:

If documenting...Load this reference
Registration, Division selection, Confirmationreferences/registration-journey.md
Schedule, Heats, Workouts, Check-inreferences/competition-day.md
Leaderboard, Scores, Final standingsreferences/results-tracking.md
Volunteer signup, Credentials, Assignmentsreferences/volunteer-journey.md

Documentation Mapping

Tutorials (3 workflows)

  • Register for Your First Competition
  • Volunteer at an Event
  • Track Your Results During Competition

How-to Guides (6 workflows)

  • Update Your Registration
  • View Your Heat Schedule
  • Check Your Division Standings
  • View Workout Standards
  • Complete Event Check-in
  • Change Division Selection

Reference (4 topics)

  • Scoring Rules
  • Division Requirements
  • Heat Format Specifications
  • Registration Status Definitions

Explanation (4 topics)

  • How Heats Work
  • Scoring Methodology
  • The Division System
  • Competition Day Flow

User Journeys

Journey 1: Discovery to Registration Find Competition → Explore Details → Register → Confirm

Journey 2: Pre-Competition Prep Check Schedule → View Workouts → Plan Strategy

Journey 3: Competition Day Check-in → View Heat Schedule → Track Scores

Journey 4: Post-Competition View Results → Compare Rankings → Share

Journey 5: Volunteer Experience Sign Up → Get Assignment → Event Day

Route Reference

RouteAuthPrimary Doc Type
/c/[slug]NoN/A (entry point)
/c/[slug]/registerYesTutorial / How-to
/c/[slug]/volunteerNoTutorial / How-to
/c/[slug]/workoutsNoReference
/c/[slug]/scheduleNoHow-to
/c/[slug]/leaderboardNoHow-to / Tutorial
/my-scheduleYesHow-to