t1k:cocos:h5:tiktok-minis
| Field | Value |
|---|---|
| Module | h5 |
| Version | 0.9.8 |
| Effort | medium |
| Tools | — |
Keywords: action minis, add to home screen, minis benchmark, minis checklist, minis kpi, minis review, revisit gift, rewarded ads placement, simulation minis, strategy minis, survivor minis, tiktok game design, tiktok h5, tiktok mini game, tiktok mini games, tiktok minis, tiktok monetization, tower defense minis, tycoon minis
How to invoke
Section titled “How to invoke”/t1k:cocos:h5:tiktok-minis[review|design] [strategy|action|simulation] [<repo-path>]Cocos H5 — TikTok Minis Review & Design
Section titled “Cocos H5 — TikTok Minis Review & Design”TikTok Minis are H5 mini games that run inside the TikTok app. This skill holds the studio’s checklist for them: the buttons every Minis game must ship, and per-genre design benchmarks (theme, core loop, progression, difficulty, ads, IAP, retention, KPI targets) for Strategy, Action and Simulation.
Two modes, one body of data:
- review: grade an existing game against the checklist and output a PASS / FAIL / N/A report.
- design: use the genre benchmarks as the frame for a new game concept or a feature plan.
Not this skill: building or packing the game (H5CocosTemplate + t1k-cocos-h5-jenkins-setup
own the build job), and not playable ads (playable module). The TikTok SDK calls themselves are
cocos-platform-sdk code; this skill says which platform features a game should expose, not how
the SDK wires them.
Decision Tree
Section titled “Decision Tree”| Intent | Load |
|---|---|
| “Does this game have every button Minis expects?” | references/base-button-checklist.md (all genres) |
| Review or design a tower defense / backpack / merge / auto-battle / idle strategy game | base checklist + references/genre-strategy.md |
| Review or design a survivor / shooter / roguelike / hack-and-slash / arena game | base checklist + references/genre-action.md |
| Review or design a tycoon / manager / idle / ASMR / life-sim game | base checklist + references/genre-simulation.md |
| “What KPI should this game hit?” | the genre file’s KPI Benchmark section only |
| Genre is unclear or hybrid | ask the user which genre to grade against; for a real hybrid, grade against both and say so |
Load only the genre file you need; each one is self-contained.
Review workflow
Section titled “Review workflow”- Identify the genre. Read it from the game’s design doc or the user. If neither says, ask; do not infer it from asset names.
- Button pass. Walk every row of the base checklist. For each button, find evidence: a scene/prefab node, a script handler, or a screenshot from a play session. Mark
PASS(found and works),FAIL(missing or broken), orN/A(the row says “if supported” and the game does not support it, e.g. Remove Ads without IAP). - Genre pass. Walk the genre file’s design sections (core loop, progression, difficulty, monetization, retention). Mark each benchmark
MEETS,BELOW, orUNKNOWN. Mark a benchmark that needs live data (session time, D1, IPU, ROAS)UNKNOWNunless the user supplied the numbers; never estimate a KPI. - Report. Use the template below. Order FAILs by what blocks a Minis review first: missing core buttons, then platform features, then monetization, then design benchmarks.
## TikTok Minis review: <game> (<genre>)Evidence: <scene/prefab paths, build URL, or "screenshots from <date>">
### Buttons: <n> PASS / <n> FAIL / <n> N/A| # | Button | Result | Evidence / fix |
### Genre benchmarks: <genre>| Section | Benchmark | Game | Result |
### KPI (only if data supplied)| KPI | Target | Actual | Result |
### Top fixes1. ...Design workflow
Section titled “Design workflow”- Pick the genre file. Start from its Recommended Design Formula: it is the intended player journey from first session to the KPI target.
- Choose a theme from Theme & Gameplay Trend and Top Trending Gameplay (the share column shows how much of the Minis chart each gameplay type holds).
- Plan the first 3 minutes against the time benchmarks (tutorial, first upgrade, first unlock). On TikTok these matter most: players arrive from a video feed and leave fast.
- Place rewarded ads at the listed placements, and add the base checklist’s monetization and platform rows to the feature list from the start, not after.
- State the KPI targets as the success criteria of the plan.
Hard rules
Section titled “Hard rules”- Benchmarks are studio targets, not TikTok rules. The KPI and timing numbers come from the studio’s internal market research. TikTok does not reject a game for a session time under 25 minutes, but it does expect the platform features (Add to Home Screen, Share, rewarded ads) to work.
- KPI units differ by genre file. Strategy lists IPU as
≥ 6%; Action and Simulation list it as≥ 11and≥ 20. These are copied as the source states them. Ask the user which definition their dashboard uses before comparing. - Interstitials: Action skips the interstitial after level 1, and Strategy shows it only after a battle. An interstitial in the first session hurts D1 on TikTok.
- “If supported” rows are not failures. Share, Add to Home Screen, Login and Remove Ads depend on platform/IAP support; mark them N/A with a reason, not FAIL.