training-navigation-vendor-agnostic
Navigate web-based trainings that gate progress via timers/videos/disabled Next buttons.
When & Why to Use This Skill
This Claude skill automates the navigation of web-based training platforms by intelligently handling progress gates such as countdown timers, mandatory video playback, and disabled navigation buttons. Using Playwright, it monitors page states, interacts with quizzes, and ensures smooth progression through vendor-agnostic training modules, significantly reducing manual waiting time and improving productivity during repetitive learning tasks.
Use Cases
- Automating mandatory corporate compliance or safety training that enforces time-based progress locks and 'must-watch' video requirements.
- Navigating through multi-slide onboarding modules that require specific scrolling or interaction triggers to enable the 'Next' button.
- Efficiently completing repetitive web-based certifications by automatically polling for timer completion and interacting with simple quiz elements or acknowledgments.
- Bypassing UI-level progress gating in vendor-agnostic training environments where the user has already mastered the content but is restricted by system-enforced delays.
| name | "Training navigation (vendor-agnostic)" |
|---|---|
| description | "Navigate web-based trainings that gate progress via timers/videos/disabled Next buttons." |
Core Skills Reference
- Use browser-automation-core for:
- Selector strategy (stability first).
- Basic waiting & scrolling logic.
- Handling overlays/modals.
- General HITL (Auth/Safety).
Preconditions
- User is signed in (or is ready to sign in when prompted).
- Training URL is provided in chat as session-only:
<TRAINING_URL>(do not store in repo files).
Training-Specific Gating & Progress
- Gating Signals:
- Disabled Next (
disabled,aria-disabled="true"). - Countdown timers (“You can continue in 00:30”).
- “Must watch video” / “watch until the end” requirements.
- Required acknowledgements/quizzes.
- Disabled Next (
- Long-Duration Polling:
- Unlike standard UI waits, training timers may last minutes.
- Use bounded polling loops: Re-check every 10–20s, up to a max window (e.g., 5–15 mins).
- Between polls, verify landmarks (button enabled, timer reached 0).
- Completion Landmarks:
- Next/Continue enables.
- Timer reaches 0 then disappears.
- “Completed” badge/checkmark appears.
- "Certificate of Completion" page appears (strong signal to exit).
Steps (Training Workflow)
- Open training: Navigate to
<TRAINING_URL>. - Find "Advance" Control: Look for "Next", "Continue", "Start", "Resume".
- Detect Gating: Check if advance control is disabled or if timers/video requirements exist.
- Handle Content:
- Videos: Play video, monitor progress/timer.
- Quizzes: Select answers (prefer clicking
<label>text), Submit, then Continue. - Scroll: Scan for hidden controls at bottom/footer if not visible.
- Advance: Click Next/Continue when enabled.
- Repeat: Until course completion.
HITL Points (Training Specific)
- Exit Confirmation: If clicking "Exit" triggers a "Are you sure?" dialog, treat the secondary confirmation as the irreversible action requiring HITL.
- Certificates: Ask before generating/downloading if it implies "finishing".
Recovery Rules (Training Specific)
- Stuck on Slide:
- Check for "mark as read" checkboxes or small interactions required.
- Check if a video ended but didn't auto-trigger "complete" (try scrubbing to end).
- Menu Exits: If "Exit" is the only way out, verify if it saves progress or completes the course.