qa-test-theme

Detect broken theme toggles and missing persistence on web pages.

Updated May 22, 2026
One-click install
npx skills add https://github.com/Luqman-Ud-Din/blackbox-qa-agent --skill qa-test-theme
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qa-test-theme
Source: https://github.com/Luqman-Ud-Din/blackbox-qa-agent/tree/main/skills/qa-test-theme
Command: npx skills add https://github.com/Luqman-Ud-Din/blackbox-qa-agent --skill qa-test-theme

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill checks whether a site’s dark or light theme control actually changes the page appearance and whether that preference is saved for future visits.

Core Features & Use Cases

  • Theme toggle validation: Confirms that clicking a theme control changes visual state or theme attributes.
  • Persistence check: Detects whether the chosen theme is written to durable storage such as localStorage or cookies.
  • Use case: Use it when a web app has a dark mode switch and you need to know if it works correctly across reloads and sessions.

Quick Start

Use the qa-test-theme skill to inspect the current page for a theme toggle, verify that it changes the theme, and report whether the preference persists.

Frequently Asked Questions about qa-test-theme

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify if a dark mode toggle persists after a page reload?

To verify dark mode persistence, an in-page probe toggles the theme, inspects visual attributes, and checks if the preference is saved to localStorage or cookies before reloading the page to confirm the state survives.

What is theme persistence testing and why is it needed for web apps?

Theme persistence testing checks whether a site’s dark or light mode control actually changes visual state and saves that preference to durable storage like localStorage or cookies for future visits and sessions.

How to test light mode and dark mode controls on desktop web pages?

Testing light and dark mode controls on desktop viewports requires clicking the theme toggle, comparing visual attributes to confirm the page state updates, and inspecting theme-related storage to ensure the preference is recorded.

Does theme toggle testing restore the original page theme after checking?

Yes, theme toggle testing restores the original theme after verifying the dark or light mode control updates the page state and successfully writes the preference to durable storage such as cookies or localStorage.

Why does my UI theme toggle change visually but fail to save to localStorage?

A UI theme toggle might change visual attributes but fail to save because the web page lacks the logic to write the preference to durable storage like localStorage or cookies, meaning the state will not survive reloads.