ui-debugging

Standardize UI bug reports with a structured screenshot protocol.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/ChinchillaEnterprises/ChillSkills --skill ui-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ui-debugging
Source: https://github.com/ChinchillaEnterprises/ChillSkills/tree/main/ui-debugging
Command: npx skills add https://github.com/ChinchillaEnterprises/ChillSkills --skill ui-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Describing visual UI/layout bugs in screenshots often leads to ambiguity, requiring multiple rounds of clarification and slowing down the debugging process. This Skill provides a standardized, structured protocol for communicating visual problems, ensuring clarity on the first try and accelerating bug resolution.

Core Features & Use Cases

  • Structured Screenshot Protocol: Guides on when to take full-page vs. viewport screenshots and what essential information to include in the description.
  • Standardized Layout Issue Template: Provides a clear template for describing "What I See," "What I Expected," and "The Problem," along with layout layers and context.
  • Visual Inspection Checklist: Ensures all necessary details are captured before sharing, preventing back-and-forth questions and speeding up communication.

Quick Start

Use the ui-debugging skill to describe this screenshot of a broken page layout.

Frequently Asked Questions about ui-debugging

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

FAQPage Schema
How do I communicate UI bugs clearly in screenshots?

Use a standardized screenshot protocol that includes the URL, platform, what you see versus what you expected, the specific problem, layout layers, and viewport information. This structured approach eliminates ambiguity and accelerates bug resolution by providing developers all context on the first report.

When should I take a full-page screenshot versus a viewport screenshot for bug reporting?

Take full-page screenshots to show layout issues across the entire document, and viewport-specific screenshots to capture responsive design problems or localized visual bugs. The ui-debugging protocol guides you on which to use based on whether the issue spans the whole page or appears in a specific viewing context.

What information should I include when reporting a layout issue or visual bug?

Report layout issues by documenting the URL, platform (web or mobile), what you see, what you expected, the specific problem, layout layers involved, and viewport dimensions. A standardized template ensures developers receive complete defect descriptions without follow-up clarification.

Can I use a screenshot protocol for responsive design problems across web and mobile?

Yes, the ui-debugging protocol applies to both web and mobile responsive design problems. It covers full-page and viewport-specific scenarios, helping you document visual bugs consistently whether testing on desktop, tablet, or mobile platforms.

How does a standardized bug reporting template reduce debugging time?

A structured template with fixed sections—URL, platform, visual state, expectations, problem description, and layout context—eliminates back-and-forth questions. Developers receive complete information immediately, allowing them to reproduce and fix the issue faster without requests for clarification.