Skip to content

t1k:cocos:h5:tiktok-minis

FieldValue
Moduleh5
Version0.9.8
Effortmedium
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

/t1k:cocos:h5:tiktok-minis
[review|design] [strategy|action|simulation] [<repo-path>]

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.

IntentLoad
“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 gamebase checklist + references/genre-strategy.md
Review or design a survivor / shooter / roguelike / hack-and-slash / arena gamebase checklist + references/genre-action.md
Review or design a tycoon / manager / idle / ASMR / life-sim gamebase checklist + references/genre-simulation.md
“What KPI should this game hit?”the genre file’s KPI Benchmark section only
Genre is unclear or hybridask 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.

  1. 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.
  2. 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), or N/A (the row says “if supported” and the game does not support it, e.g. Remove Ads without IAP).
  3. Genre pass. Walk the genre file’s design sections (core loop, progression, difficulty, monetization, retention). Mark each benchmark MEETS, BELOW, or UNKNOWN. Mark a benchmark that needs live data (session time, D1, IPU, ROAS) UNKNOWN unless the user supplied the numbers; never estimate a KPI.
  4. 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 fixes
1. ...
  1. Pick the genre file. Start from its Recommended Design Formula: it is the intended player journey from first session to the KPI target.
  2. 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).
  3. 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.
  4. 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.
  5. State the KPI targets as the success criteria of the plan.
  • 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 ≥ 11 and ≥ 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.