Agent skill

Kototoro Main Loading Stability

by Kototoro-app in Kototoro-app/Kototoro

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

Apache-2.0Auto-check passed

Install Kototoro Main Loading Stability

skills CLI
$ npx skills add Kototoro-app/Kototoro --skill kototoro-main-loading-stability -a claude-code

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

GitHub CLI
$ gh skill install Kototoro-app/Kototoro kototoro-main-loading-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-main-loading-stability .claude/skills/kototoro-main-loading-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-main-loading-stability
GitHub stars
613
Token cost
~904 tokens
SKILL.md length
360 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
Apache-2.0

At a glance

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

  • FavoritesHostScreen
  • SKILL.md covers Root Cause Pattern, Preferred Fix Pattern, Favorites-Specific Pattern and Navigation Chrome Pattern, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • FavouritesContainerViewModel

What it does

Kototoro Main Loading Stability is an agent skill from Kototoro-app/Kototoro. Diagnose and fix Kototoro main screen loading flicker, blank flashes, chrome jumps, transient empty states, and route switching flashes. Use for KototoroApp, AppNavGraph, FavoritesHostScreen, FavouritesContainerViewModel, DiscoverViewModel, collectAsStateWithLifecycle initial values, top/bottom bar offsets, and main route transitions.

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

The repository describes itself as: Manga, Novel, and Video reader for Android. The licence is Apache-2.0.

When your agent uses it

  • FavoritesHostScreen
  • FavouritesContainerViewModel
  • DiscoverViewModel
  • CollectAsStateWithLifecycle initial values

Example prompts

  • “/kototoro-main-loading-stability”

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 Main Loading Stability loads about 904 tokens when it runs. Until then it costs about 92 tokens; SKILL.md has 360 words of instructions outside code blocks.

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

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). 360 words, ~904 tokens.

Download SKILL.mdSave it as .claude/skills/kototoro-main-loading-stability/SKILL.md (or your agent's skills folder).
name
kototoro-main-loading-stability
description
Diagnose and fix Kototoro main screen loading flicker, blank flashes, chrome jumps, transient empty states, and route switching flashes. Use for KototoroApp, AppNavGraph, FavoritesHostScreen, FavouritesContainerViewModel, DiscoverViewModel, collectAsStateWithLifecycle initial values, top/bottom bar offsets, and main route transitions.

Kototoro Main Loading Stability

Use this skill when a main tab briefly flashes empty/loading UI, top or bottom chrome jumps, route switching fades incorrectly, or disabled browse recommendation loading still causes visible churn.

Root Cause Pattern

Main screen flicker usually comes from ambiguous state, not drawing alone:

  • UI infers loading from categories.isEmpty() or items.isEmpty().
  • collectAsStateWithLifecycle(initialValue = emptyList()) creates a fake empty first frame.
  • Favorites filtering emits empty counts before raw favorites are loaded.
  • Disabled recommendation features still emit loading/refresh changes.
  • Top/bottom chrome offsets from the previous destination are reused by the next destination.
  • Main route transitions are either absent when a small fade is needed or applied to non-main routes where they create visible churn.

Preferred Fix Pattern

  • Introduce explicit UI state with isLoading, data, and isEmpty.
  • Use ViewModel stateIn initial values that represent real loading, not fake content.
  • Avoid initialValue = emptyList() when the underlying StateFlow already has a meaningful value.
  • Gate recommendation/discover loading with a predicate like:
kotlin
private fun shouldLoadBrowseRecommendations(query: String = searchQuery.value.trim()): Boolean {
    return isBrowseTrackingRecommendationsEnabled.value || query.isNotBlank()
}
  • Reset chrome offsets when the current main destination changes.
  • Scope effective top/bottom offsets to the destination that produced them.
  • Limit route transition fade to main-route to main-route transitions.

Favorites-Specific Pattern

Use a single host UI state instead of separate categories and isEmpty streams:

kotlin
data class FavoritesHostUiState(
    val isLoading: Boolean = true,
    val categories: List<FavouriteTabModel> = emptyList(),
    val isEmpty: Boolean = false,
)

When source/language filters are inactive, emit NotFiltered rather than waiting on the raw favorites stream. When filters are active, emit Loading before filtered counts arrive.

Show full SKILL.md (135 more words)Show less

Navigation Chrome Pattern

  • Keep offsetDestinationRoute.
  • Compute effectiveTopBarOffset and effectiveBottomNavOffset only when the offset belongs to the current destination.
  • On main destination change, reset top and bottom offsets to zero.
  • In AppNavGraph, use a short fade only if both initial and target destinations are main routes.

Pitfalls

  • Do not show empty state while data is still loading.
  • Do not start disabled recommendation loads just to clear state; explicitly clear and return.
  • Do not reuse scroll-derived top bar offsets across route changes.
  • Do not apply main-route fade transitions to details/search/player-like routes.

Verification

Run:

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

Manual acceptance:

  • Main tabs do not flash empty state before real content arrives.
  • Favorites shows loading, real empty, and content states distinctly.
  • Browse recommendation disabled state does not keep refreshing hidden content.
  • Top/bottom chrome does not jump when switching tabs or returning from details/player.

© 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-main-loading-stability of Kototoro-app/Kototoro.

Open the folder on GitHubat commit 74bd979

Compare with similar skills

Kototoro Main Loading 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 Main Loading Stability compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Kototoro Main Loading Stability this skillKototoro-app/Kototoro613—~904Automated safety check: PassApache-2.0
Diagnosing Compose StabilityrosuH/EasyWatermark1.9k1 repos~3.3kAutomated safety check: PassApache-2.0
Diagnose Gatewayopenclaw/openclaw392k—~670Automated safety check: PassMIT
Diagnosegithub/awesome-copilot40k1 repos~1kAutomated safety check: PassMIT
Loading Indicatorsthedaviddias/Front-End-Checklist74k—~434Automated safety check: PassMIT
Font Loadingthedaviddias/Front-End-Checklist74k—~400Automated safety check: PassMIT

Similar skills

  • Diagnosing Compose Stability

    rosuH/EasyWatermark

    A skill your agent uses to diagnose Jetpack Compose stability problems by enabling and reading the Compose Compiler Reports (classes.txt, composables.txt, composables.csv, module.json).

    1.9k GitHub starsUsed in 1 repo~3.3k tokens
    MobileAuto-check passed
  • Diagnose Gateway

    openclaw/openclaw

    Diagnose Gateway, config, secrets, channels, and port failures with read-only one-liners.

    392k GitHub stars~670 tokensUpdated today
    Auto-check passed
  • Diagnose

    github/awesome-copilot

    Official

    Perform a systematic diagnostic scan of an AI workflow across 5 quality dimensions — prompt quality, context efficiency, tool health, architecture fitness, and safety — producing a scored report…

    40k GitHub starsUsed in 1 repo~1k tokens
    Agent WorkflowsAuto-check passed
  • Loading Indicators

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing slow page loads, heavy assets, or rendering delays related to Show loading indicators.

    74k GitHub stars~434 tokensUpdated 5 days ago
    Frontend & DesignAuto-check passed
  • Font Loading

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing slow page loads, heavy assets, or rendering delays related to Optimize web font loading.

    74k GitHub stars~400 tokensUpdated 5 days ago
    Frontend & DesignAuto-check passed
  • Lazy Loading

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing slow page loads, heavy assets, or rendering delays related to Implement lazy loading for offscreen content.

    74k GitHub stars~487 tokensUpdated 5 days ago
    Frontend & DesignAuto-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
  • 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…

    613 GitHub stars~946 tokensUpdated yesterday
    Auto-check passed

Questions about Kototoro Main Loading Stability

What does Kototoro Main Loading Stability do?

Diagnose and fix Kototoro main screen loading flicker, blank flashes, chrome jumps, transient empty states, and route switching flashes. Kototoro Main Loading Stability is an agent skill from Kototoro-app/Kototoro. Diagnose and fix Kototoro main screen loading flicker, blank flashes, chrome jumps, transient empty states, and route switching flashes.

When should I use Kototoro Main Loading Stability?

Kototoro Main Loading Stability fits situations like: favoritesHostScreen; favouritesContainerViewModel; discoverViewModel; collectAsStateWithLifecycle initial values.

How do I install Kototoro Main Loading Stability in Claude Code?

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

How do I install Kototoro Main Loading Stability in Codex?

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

Can I use Kototoro Main Loading 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-main-loading-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-main-loading-stability, .gemini/skills/kototoro-main-loading-stability, .github/skills/kototoro-main-loading-stability and .opencode/skills/kototoro-main-loading-stability in your project.

What does Kototoro Main Loading Stability need to run?

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

Does Kototoro Main Loading 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 Main Loading 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 Main Loading Stability use?

Kototoro Main Loading 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 Main Loading Stability use?

About 904 tokens (SKILL.md is roughly 3.6k 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 Main Loading Stability?

Skills that share tags, products or a category with Kototoro Main Loading Stability: Diagnosing Compose Stability (rosuH/EasyWatermark, 1.9k stars), Diagnose Gateway (openclaw/openclaw, 392k stars), Diagnose (github/awesome-copilot, 40k stars) and Loading Indicators (thedaviddias/Front-End-Checklist, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kototoro Main Loading 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.