kototoro-details-return-stability

Diagnose and fix UI stability issues when returning from reader or video player in Kototoro.

467|36|Updated Oct 28, 2025
One-click install
npx skills add https://github.com/Kototoro-app/Kototoro --skill kototoro-details-return-stability
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kototoro-details-return-stability
Source: https://github.com/Kototoro-app/Kototoro/tree/main/.codex/skills/performance/kototoro-details-return-stability
Command: npx skills add https://github.com/Kototoro-app/Kototoro --skill kototoro-details-return-stability

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill resolves flickers, cover reloads, and progress resets when returning to details in the Kototoro Android app, providing a more stable and reliable reading experience.

Core Features & Use Cases

  • Fix Reader Issues: Handles common issues like cover flashes, panorama reloads, and progress reset after returning from reader or video player.
  • Diagnose Stability Issues: Offers debugging tips for identifying when and why details subtree is recreated.
  • Stable UI: Ensures the system bars and status bar insets are stable for a consistent look and feel.

Quick Start

Run the provided script to diagnose stability issues in Kototoro.

Frequently Asked Questions about kototoro-details-return-stability

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

FAQPage Schema
Why does the Android UI flicker and reload covers when returning from the reader?

Flickers and cover reloads occur when the details subtree is unnecessarily recreated during Android UI transitions. Diagnosing the lifecycle of DetailsScreen helps identify why the state resets upon returning from the reader.

How do I fix progress reset issues after returning from a video player in Android?

To fix progress reset issues after returning from a video player, you must diagnose and resolve recreation issues in VideoPlayerActivity and DetailsScreen. This ensures the UI state persists seamlessly during the transition.

How can I stabilize system bars and status bar insets during Android activity transitions?

Stabilizing system bars and status bar insets requires fixing activity recreation issues in MainActivity and related screens. This ensures consistent system bar visibility and prevents inset fluctuations during navigation.

What is the best way to debug details subtree recreation in an Android reading app?

The best way to debug details subtree recreation is running dedicated diagnostic scripts to trace the lifecycle. This pinpoints exactly when and why the details subtree is recreated after closing the reader.

Do I need a specific app environment to diagnose UI stability issues with this script?

Yes, diagnosing UI stability issues with this script requires the Kototoro app environment. The diagnostic script specifically targets transition issues within DetailsScreen, VideoPlayerActivity, and MainActivity.