kde-plasma-widget-dev

Debug and fix KDE Plasma 6 plasmoid and QML widget issues.

Updated Nov 29, 2025
One-click install
npx skills add https://github.com/endlessblink/flow-state --skill kde-plasma-widget-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kde-plasma-widget-dev
Source: https://github.com/endlessblink/flow-state/tree/main/.claude/skills/kde-plasma-widget-dev
Command: npx skills add https://github.com/endlessblink/flow-state --skill kde-plasma-widget-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

KDE Plasma widget development often suffers from subtle issues that prevent plasmoids from loading, rendering icons, or integrating with the system tray, causing wasted debugging time and user frustration.

Core Features & Use Cases

  • Develop, debug, and fix KDE Plasma 6 widgets (plasmoids) with guided workflows.
  • Detect and resolve common issues like emoji rendering, widget not appearing in panels, and import problems for Plasma 6.
  • Use plasmoidviewer for testing and verify structured widget packages (metadata.json, contents/ui, contents/config) across project lifecycles.

Quick Start

Open the widget project in your IDE and run plasmoidviewer to test.

Frequently Asked Questions about kde-plasma-widget-dev

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

FAQPage Schema
How do I debug a KDE Plasma widget that is not showing up in the panel?

To debug a KDE Plasma widget not showing in the panel, validate the project structure including metadata.json and contents/ui/main.qml, then run plasmoidviewer to test the plasmoid loading process and identify integration errors.

Why is my Plasma 6 plasmoid failing to render emojis correctly?

Plasma 6 plasmoid emoji rendering issues often stem from incorrect QML imports or missing configurations. Validate the widget structure and apply guided debugging workflows to detect and resolve these common rendering problems.

What is the correct file structure for a KDE Plasma 6 plasmoid?

The correct KDE Plasma 6 plasmoid structure requires a valid metadata.json file alongside properly organized contents/ui and contents/config directories to ensure the package loads and functions correctly during testing.

How do I test a plasmoid using plasmoidviewer during development?

You test a plasmoid using plasmoidviewer by opening your widget project in an IDE and executing the tool to render the UI, allowing you to verify display behavior and troubleshoot issues across the project lifecycle.

Can I use Kirigami components in my KDE Plasma widget development workflow?

Yes, you can use Kirigami components in KDE Plasma widget development workflows. The debugging process covers Kirigami usage to help identify and resolve import problems or display issues within your plasmoid.

What should I do if my Plasma widget has system tray integration problems?

For Plasma widget system tray integration problems, check your metadata.json and contents/ui structure for errors. Use plasmoidviewer to replicate the environment and apply troubleshooting workflows to fix the integration issues.