shine-debug

Diagnose persistent SHINE debugging sessions with structured root-cause reporting.

1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/diShine-digital-agency/SHINE-Code-System --skill shine-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shine-debug
Source: https://github.com/diShine-digital-agency/SHINE-Code-System/tree/main/skills/shine-debug
Command: npx skills add https://github.com/diShine-digital-agency/SHINE-Code-System --skill shine-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

SHINE debugging issues across persistent context resets by coordinating subagents and checkpoints to surface root causes and guide fixes.

Core Features & Use Cases

  • Coordinate symptom gathering across sessions and manage dedicated shine-debugger subagents.
  • Handle checkpoints and provide root-cause reporting with actionable fix plans.
  • Support diagnose-only mode and continuation flows to apply fixes safely.

Quick Start

Describe the issue to investigate and initiate a shine-debugger session to begin diagnostics.

Frequently Asked Questions about shine-debug

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

FAQPage Schema
How do I debug issues across persistent context resets without losing session state?

To debug across context resets, this Skill coordinates symptom gathering and manages dedicated subagents within persistent debugging sessions. It uses checkpoint handling to preserve state, ensuring you resume investigations seamlessly without losing prior diagnostic context.

What is the best way to structure root-cause reporting for complex bug investigations?

Structured root-cause reporting is generated through a deterministic workflow that applies flags and agent spawning. This approach surfaces actionable fix plans and guides the resolution process by orchestrating subagents to systematically isolate the underlying issue.

Can I run diagnostics in a diagnose-only mode to plan fixes safely before applying changes?

Yes, you can run diagnostics in a diagnose-only mode to safely plan fixes. This mode investigates symptoms and reports root causes without applying changes, and continuation flows are supported to apply the planned fixes only when you are ready.

How does subagent orchestration work for diagnosing and resolving software issues?

Subagent orchestration works by spawning dedicated debugger agents within a deterministic workflow. These agents handle checkpoint operations and gather symptoms across sessions, coordinating to investigate bugs and generate structured root-cause reports for guided fixes.

Why does my debugging workflow fail to maintain state across different agent sessions?

Debugging workflows fail to maintain state across sessions when they lack persistent checkpoint handling. This Skill resolves that by managing dedicated debugging subagents and applying deterministic flags to preserve diagnostic context across context resets.

Do I need the SHINE framework to use persistent debugging checkpoints and subagent coordination?

Yes, the SHINE framework is required as this Skill implements debugging specifically within the SHINE architecture. It leverages SHINE sessions for checkpoint handling, agent spawning, and structured root-cause reporting to guide fixes.