Maintaining Lab Quality with Skillable’s Bug Reporting

Overview

Once labs are developed and quality assured, they’re typically pushed to production and rarely revisited. Over time, however, labs can become outdated due to silent changes like OS updates, browser behavior shifts, or third-party platform modifications.

While post-event evaluations may surface lab issues, feedback is often vague or lacks context. Users may not recall which lab, step, or condition triggered the problem.

Skillable addresses this challenge with the lab bug reports feature in Skillable Studio. This feature enables users to submit detailed, contextualized bug reports directly from within the lab environment. Each report is automatically linked to the relevant Lab Profile and can notify designated stakeholders (e.g., Lab Profile owners or Quality Managers) via email. This ensures feedback is timely, traceable, and actionable—supporting continuous lab quality improvement.

Enable Bug Reporting

Bug reporting is configured per Lab Profile. As a best practice, enable it on any Lab Profile published to an API consumer or exposed to learners.

To enable bug reporting:

1. Open the Lab Profile in Studio.

2. Along the top, click Edit Profile to open the Lab profile editor.

3. Scroll to the bottom of the Basic Information page.

4. Check Enable Bug Reporting.

5. (Optional but recommended) In the Bug Report Email Address field, enter an email address to receive notifications when new reports are submitted.

Submit a Bug Report

Bug reports can be submitted through one of three interfaces:

• Lab Clientnt (by end users)

• Lab Profile page (by authors/admins)

• Bug Report Manager in Studio (for organization-wide management)

Submit a Bug Report via the Lab Client

To report a bug as a learner:

1. In the upper-right corner of a running lab, select Help > Report a bug.

2. Fill in the structured form:

   1. Please enter a one-line summary*: In the text field, enter a brief description of the issue.

   2. Steps to reproduce the problem*: In the text box, enter clears steps to replicate the issue.

   3. Expected behavior: In the text box, enter what you expected to happen.

   4. What went wrong*: In the text box, enter what actually occurred.

   5. (Optional) Any other comments: In the text box, enter any additional context or observations.

   6. (Optional) Include a screenshot of my currently selected machine: Attach a VM screenshot if applicable.

3. Click Submit Bug Report.

Submit a Bug Report via the Lab Profile Page

Lab authors and admins can manually log bugs against a Lab Profile.

To report a bug as an author or admin:

1. Open the Lab Profile in Studio.

2. From the Lab Profile details, scroll to Open Bug Reports and expand the section.

3. Click + Create Bug Report.

4. Fill in the bug metadata:

   1. Status: Unconfirmed*, Confirmed, Fix in Progress, Fixed, Invalid, Duplicate, or Won’t Fix.

   2. Severity: Trivial, Minor*, Major, Critical, or Blocker.

   3. Priority: Immediate, High, Medium*, Low

   4. Assigned To: Designate a Lab Developer or SME

   5. (Optional) Target: Enter a resolution date

   * Default value indicated.

Create a Bug Report via the Bug Report Manager

To report a bug report using the Bug Report Manager:

1. In Studio, navigate to Admin > Lab Profiles > Bug Reports.

   The Find Bug Reports page opens.

2. In the upper-left corner, click Create Bug Report.

3. On the structured form, select the Lab Profile associated with the bug report.

4. Fill in the bug metadata (*default value indicated):

   1. Status: Select Unconfirmed*, Confirmed, Fix in Progress, Fixed, Invalid, Duplicate, or Won’t Fix

   2. Severity: Select Trivial, Minor*, Major, Critical, or Blocker

   3. Priority: Select Immediate, High, Medium*, or Low

   4. Assigned To: Designate a Lab Developer or SME

   5. (Optional) Target: Enter a resolution date

Manage Bug Reports in Studio

You can manage bug reports in two ways:

• From the Lab Profile page: View and manage reports for a single lab.

• From the Find Bug Reports tool: Search and manage reports across all Lab Profiles in your organization.

Find Bug Reports

The Find Bug Reports search page supports these actions:

• Creating new bug reports

• Finding and filter reports by status, severity, priority, assignee, keywords, and more

• Viewing report details, including VM screenshots (if available)

• Editing and updating report fields

This centralized view supports triage, prioritization, and resolution tracking across your lab portfolio.

To access the Find Bug Reports page:

1. In Studio, navigate to Admin > Lab Profiles > Bug Reports.

   The Find Bug Reports page opens.

2. Use the filters to narrow your search terms.

3. Click Search to return bug reports based on your filtered criteria.

Edit Bug Reports

When editing a report, you can:

• Update status, severity, priority, and assignment

• Add or refine reproduction steps and error details

• Track progress through to resolution using the status workflow

To edit an existing bug report:

1. In Studio, navigate to Admin > Lab Profiles > Bug Reports.

   The Find Bug Reports page opens.

2. Navigate to the bug report you want to edit, using filters to narrow your search as needed.

3. To the right of the bug report, click Edit.

4. Update the bug report as needed and then save your changes.

Summary

Skillable’s lab bug reporting feature embeds structured, contextual feedback directly into the lab experience, making it easier to identify, triage, and resolve issues as they arise. By centralizing bug reporting and management in Skillable Studio, teams can proactively maintain high-quality, learner-ready labs—at scale.