Agent skill

Kototoro Details Return Stability

by Kototoro-app in Kototoro-app/Kototoro

Diagnose and fix Kototoro Android issues where returning from reader or video player to details causes flicker, cover reload, panorama reload, progress reset, status bar jump, Compose subtree…

Apache-2.0Auto-check passedMobile

Install Kototoro Details Return Stability

skills CLI
$ npx skills add Kototoro-app/Kototoro --skill kototoro-details-return-stability -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Kototoro-app/Kototoro kototoro-details-return-stability --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Kototoro-app/Kototoro.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/performance/kototoro-details-return-stability .claude/skills/kototoro-details-return-stability && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
kototoro-details-return-stability
GitHub stars
613
Token cost
~946 tokens
SKILL.md length
383 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
Apache-2.0

At a glance

Diagnose and fix Kototoro Android issues where returning from reader or video player to details causes flicker, cover reload, panorama reload, progress reset, status bar jump, Compose subtree…

  • Works in 5 steps: Prove whether the details subtree is… → Check whether MainActivity is recreated.… → Check system bar visibility and inset… → …
  • VideoPlayerActivity
  • SKILL.md covers Debug Order, Minimal Diagnostics, Known Fix Pattern and Reader Duplicate Page Guardrail, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Kototoro Details Return Stability is an agent skill from Kototoro-app/Kototoro. Diagnose and fix Kototoro Android issues where returning from reader or video player to details causes flicker, cover reload, panorama reload, progress reset, status bar jump, Compose subtree disposal, or Activity recreation. Use for DetailsScreen, VideoPlayerActivity, MainActivity, system bars/insets, shared transition, Coil cache key, and reader page identity regressions.

Its SKILL.md is about 950 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile. It works with Android. The repository describes itself as: Manga, Novel, and Video reader for Android. The licence is Apache-2.0.

When your agent uses it

  • VideoPlayerActivity
  • System bars/insets
  • Shared transition
  • Reader page identity regressions

Example prompts

  • “/kototoro-details-return-stability”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Prove whether the details subtree is recreated before touching image code.
  2. Check whether MainActivity is recreated. If the Activity instance changes, local Coil or Compose fixes only mask the symptom.
  3. Check system bar visibility and inset stability. Transparent bars and hidden bars are different; hidden bars change insets.
  4. Only after lifecycle/insets are stable, inspect Coil request identity, cache keys, and crossfade.
  5. For reader page regressions, verify page identity includes chapter and URL, not just duplicate parser page IDs.

What it can do on your machine

Read from SKILL.md and the folder at commit 74bd979. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are kotlin and bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Kototoro Details Return Stability loads about 946 tokens when it runs. Until then it costs about 103 tokens; SKILL.md has 383 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~103
When it runs · the whole SKILL.md, loaded when a task matches
~946

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Kototoro-app/Kototoro at commit 74bd979, republished under its Apache-2.0 licence (© Kototoro-app). 383 words, ~946 tokens.

Download SKILL.mdSave it as .claude/skills/kototoro-details-return-stability/SKILL.md (or your agent's skills folder).
name
kototoro-details-return-stability
description
Diagnose and fix Kototoro Android issues where returning from reader or video player to details causes flicker, cover reload, panorama reload, progress reset, status bar jump, Compose subtree disposal, or Activity recreation. Use for DetailsScreen, VideoPlayerActivity, MainActivity, system bars/insets, shared transition, Coil cache key, and reader page identity regressions.

Kototoro Details Return Stability

Use this skill when a return path to details looks visually unstable: cover flashes, panorama flashes, source icon reloads, progress briefly resets, top area jumps, or logs suggest DetailsScreen is disposed and recreated.

Debug Order

  1. Prove whether the details subtree is recreated before touching image code.
  2. Check whether MainActivity is recreated. If the Activity instance changes, local Coil or Compose fixes only mask the symptom.
  3. Check system bar visibility and inset stability. Transparent bars and hidden bars are different; hidden bars change insets.
  4. Only after lifecycle/insets are stable, inspect Coil request identity, cache keys, and crossfade.
  5. For reader page regressions, verify page identity includes chapter and URL, not just duplicate parser page IDs.

Minimal Diagnostics

Add temporary logs, then remove them before final commit:

kotlin
DisposableEffect(content?.id, content?.source?.name, content?.url) {
    Log.d("DetailsLifecycle", "DetailsScreen enter id=${content?.id} source=${content?.source?.name} url=${content?.url}")
    onDispose {
        Log.d("DetailsLifecycle", "DetailsScreen dispose id=${content?.id} source=${content?.source?.name} url=${content?.url}")
    }
}

Also log MainActivity onCreate/onDestroy if the details subtree is disposed. A changing MainActivity@... in ImageRequest.context is strong evidence of Activity recreation.

Known Fix Pattern

  • MainActivity should handle the same relevant config changes as the player when video orientation or fullscreen UI can affect the background Activity: orientation|screenSize|keyboardHidden|smallestScreenSize|screenLayout|uiMode.
  • VideoPlayerActivity can use transient immersive bars for visual fullscreen, but avoid explicit show/hide churn on exit.
  • Details should use stable status bar insets such as WindowInsets.statusBarsIgnoringVisibility; keep a fallback from Android status_bar_height when current inset is 0.dp.
  • Coil requests used by details covers, panorama, source options, and home hero should use stable memoryCacheKey/diskCacheKey derived from source, owner URL/id, and image URL.
  • Disable crossfade for already-present details hero/cover/panorama surfaces when the goal is return stability.
  • If a log only shows non-current content keys, it may be disposal of previous home hero or transition residue, not current details reload.
Show full SKILL.md (106 more words)Show less

Reader Duplicate Page Guardrail

Some Mihon sources emit many pages with duplicate image IDs. Reader identity must not rely only on page.id.

Use composite identity including:

  • chapterId
  • page index
  • page URL
  • split part if applicable
  • source key in loader task caches

If cached manga always opens or renders as page one, inspect ReaderPage.readerKey, adapter diff keys, PageLoader task cache keys, and repository dedupe logic.

Verification

Run:

bash
JAVA_HOME="/usr/lib/jvm/java-17-openjdk-amd64" ./gradlew :app:compileDebugKotlin --no-daemon

Manual acceptance signals:

  • Returning from player does not log MainActivity onDestroy/onCreate.
  • Returning from player does not log current DetailsScreen dispose/enter.
  • Cover, source icon, progress, and panorama remain visually stable.
  • Reader cached duplicate-image manga no longer collapses to the first page.

© Kototoro-app, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .codex/skills/performance/kototoro-details-return-stability of Kototoro-app/Kototoro.

Open the folder on GitHubat commit 74bd979

Compare with similar skills

Kototoro Details Return Stability next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Kototoro Details Return Stability compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Kototoro Details Return Stability this skillKototoro-app/Kototoro613—~946Automated safety check: PassApache-2.0
Compose Multiplatform Patternsmonta-app/ocpp-emulator1805 repos~2kAutomated safety check: PassApache-2.0
Phone HarnessShawnPana/phone-harness3.2k—~7.7kAutomated safety check: PassMIT
Stylessreichholf/dreamDroid1165 repos~2.3kAutomated safety check: PassGPL-3.0
Argent Metro Debuggerbbplayer-app/BBPlayer1.2k—~3.4kAutomated safety check: PassMIT
Android XML ResourceafkT/DevUtils1.6k—~1.3kAutomated safety check: PassApache-2.0

Similar skills

  • Compose Multiplatform Patterns

    monta-app/ocpp-emulator

    Compose Multiplatform and Jetpack Compose patterns for KMP projects — state management, navigation, theming, performance, and platform-specific UI.

    180 GitHub starsUsed in 5 repos~2k tokens
    MobileAuto-check passed
  • Phone Harness

    ShawnPana/phone-harness

    Control the user's phone - an iPhone through the Mac's iPhone Mirroring window, an Android over adb, a rented cloud Android, or a cloud iPhone over HTTPS: open apps, tap, type, swipe, read the screen.

    3.2k GitHub stars~7.7k tokensUpdated today
    MobileAuto-check passed
  • Styles

    sreichholf/dreamDroid

    A skill your agent uses to integrate the Jetpack Compose Styles API into an Android project.

    116 GitHub starsUsed in 5 repos~2.3k tokens
    MobileAuto-check passed
  • Argent Metro Debugger

    bbplayer-app/BBPlayer

    Debug a JS runtime via CDP using argent debugger tools. An agent skill from bbplayer-app/BBPlayer.

    1.2k GitHub stars~3.4k tokensUpdated 3 days ago
    MobileAuto-check passed
  • 统一 Android XML 资源命名:layout、drawable、mipmap、color、values、id 的前缀与 snakecase 规则;把颜色/圆角/描边/状态编码进文件名(bg、border、textcolor…selector)。

    1.6k GitHub stars~1.3k tokensUpdated 1 mo ago
    MobileAuto-check passed
  • Mobile QA

    tloncorp/tlon-apps

    Run a mobile QA checklist on a physical Android device over adb for tlon-apps, then triage what fails into fixes.

    107 GitHub stars~2.4k tokensUpdated today
    MobileAuto-check passed

More from Kototoro-app/Kototoro

All 10 skills in this repo
  • Android Architecture Reference

    Kototoro-app/Kototoro

    Android 架构、依赖注入、数据层、测试规范官方参考。涵盖 UDF/MVI 模式、Hilt/Dagger、Room、Paging、 DataStore、WorkManager、ViewModel、测试策略等。安卓开发第一要义:参考官方文档和案例!

    613 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Android Compose Reference

    Kototoro-app/Kototoro

    Jetpack Compose 官方示例与最佳实践参考。涵盖 Compose UI 实现、动画、手势、导航、Material3 主题、 性能优化、测试等所有方面。安卓开发第一要义:参考官方文档和案例!

    613 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Android Official Samples

    Kototoro-app/Kototoro

    Android 官方示例代码库完整索引。涵盖架构、Compose UI、性能、测试、存储、网络、相机、媒体、安全等所有领域。

    613 GitHub stars~3.6k tokensUpdated yesterday
    Auto-check passed
  • Compose Idle Redraw

    Kototoro-app/Kototoro

    诊断 Kototoro 主壳"空闲永不定居"式 Compose 自持重绘循环(idle 帧数不为 0). An agent skill from Kototoro-app/Kototoro.

    613 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed
  • Kototoro Browse Source Scroll

    Kototoro-app/Kototoro

    Diagnose and fix Kototoro Browse/Explore page content source scrolling jank when many sources exist.

    613 GitHub stars~793 tokensUpdated yesterday
    Auto-check passed
  • Kototoro Main Loading Stability

    Kototoro-app/Kototoro

    Diagnose and fix Kototoro main screen loading flicker, blank flashes, chrome jumps, transient empty states, and route switching flashes.

    613 GitHub stars~904 tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Kototoro Details Return Stability

What does Kototoro Details Return Stability do?

Diagnose and fix Kototoro Android issues where returning from reader or video player to details causes flicker, cover reload, panorama reload, progress reset, status bar jump, Compose subtree…. Kototoro Details Return Stability is an agent skill from Kototoro-app/Kototoro. Diagnose and fix Kototoro Android issues where returning from reader or video player to details causes flicker, cover reload, panorama reload, progress reset, status bar jump, Compose subtree disposal, or Activity recreation.

When should I use Kototoro Details Return Stability?

Kototoro Details Return Stability fits situations like: videoPlayerActivity; system bars/insets; shared transition; reader page identity regressions.

How do I install Kototoro Details Return Stability in Claude Code?

Run `npx skills add Kototoro-app/Kototoro --skill kototoro-details-return-stability -a claude-code`. Or copy the skill folder (.codex/skills/performance/kototoro-details-return-stability in Kototoro-app/Kototoro) into .claude/skills/kototoro-details-return-stability in your project. Claude Code loads it when a task matches its description.

How do I install Kototoro Details Return Stability in Codex?

Run `npx skills add Kototoro-app/Kototoro --skill kototoro-details-return-stability -a codex`. Or copy the skill folder (.codex/skills/performance/kototoro-details-return-stability in Kototoro-app/Kototoro) into .agents/skills/kototoro-details-return-stability in your project. Codex loads it when a task matches its description.

Can I use Kototoro Details Return Stability in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Kototoro-app/Kototoro --skill kototoro-details-return-stability -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kototoro-details-return-stability, .gemini/skills/kototoro-details-return-stability, .github/skills/kototoro-details-return-stability and .opencode/skills/kototoro-details-return-stability in your project.

What does Kototoro Details Return Stability need to run?

SKILL.md names no scripts, command-line tools or credentials: Kototoro Details Return Stability is instructions for the agent only.

Does Kototoro Details Return Stability access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Kototoro Details Return Stability safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Kototoro Details Return Stability use?

Kototoro Details Return Stability is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Kototoro Details Return Stability use?

About 946 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Kototoro Details Return Stability?

Skills that share tags, products or a category with Kototoro Details Return Stability: Compose Multiplatform Patterns (monta-app/ocpp-emulator, 180 stars), Phone Harness (ShawnPana/phone-harness, 3.2k stars), Styles (sreichholf/dreamDroid, 116 stars) and Argent Metro Debugger (bbplayer-app/BBPlayer, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kototoro Details Return Stability?

Kototoro-app (a GitHub organization) maintains it in Kototoro-app/Kototoro, which has 613 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 9, 2026.

Source: Kototoro-app/Kototoro on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.