ratings-mechanics SKILL.md skillA
ratings-mechanics from rshankras/claude-code-apple-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add rshankras/claude-code-apple-skills/ratings-mechanics@git:20260716.32566aaPins git:20260716.32566aa in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- rshankras/claude-code-apple-skills
- Path
skills/app-store/ratings-mechanics/SKILL.md- Versions recorded
- 2
- Latest version
- git:20260716.32566aa, committed Jul 16, 2026
- First version recorded
- Jul 13, 2026
- Size
- 5,478 bytes
- Repository stars
- 876
- License
- MIT
How App Store ratings actually behave — per-storefront isolation (your US stars show nowhere else), the never-reset rule, phased release + manual release as rating protection, and where prompting/replying fit. Use when planning ratings strategy for new markets, considering a ratings reset, setting release options, or diagnosing "why is my rating missing in country X.".
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Ratings Mechanics
The rating is an asset with mechanics most developers learn the hard way. This skill covers the
four rules that aren't obvious from the ASC UI. Prompting *code* lives in
`generators/review-prompt`; reply *writing* lives in `app-store/review-response-writer` — this
skill is the strategy layer that tells you when each matters.
## When This Skill Activates
- Localizing or expanding into new storefronts ("why does my app show no rating in Japan?")
- Considering the "reset ratings summary" option on a version release
- Choosing release options before submitting (phased vs immediate, auto vs manual)
- Planning a per-market ratings strategy alongside `product/localization-strategy`
- A bad build or review-bomb is threatening the rating
## Rule 1: Ratings are per-storefront — they do not travel
Your 4.8★ from 2,000 US ratings renders as **no rating at all** on the Japanese storefront until
Japanese users rate the app there. Every storefront starts from zero.
Consequences:
- ✅ Entering a new market = re-running the early-days ratings playbook *in that market*: prompt
eagerly (within guidelines), localize the prompt moment, reply to every early review.
…Read the whole file at its exact version.
How to install
mdr add rshankras/claude-code-apple-skills/ratings-mechanics@sha256:0f12950688f411c2The line at the top of this page pins the label git:20260716.32566aa, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_jsi7ft5w327u6267)
0 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Jul 13, 2026 and Jul 16, 2026, about one every 3 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260716.32566aa latest | 2026-07-16 | 32566aa | 5,478 B | A | view · diff |
| git:20260713.d560c0c | 2026-07-13 | d560c0c | 5,430 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (5478 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
rshankras/claude-code-apple-skills · 876 stars · license MIT · pushed 2026-11-09 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_jsi7ft5w327u6267 GET https://markdownregistry.com/api/v1/resolve?ref=rshankras/claude-code-apple-skills/ratings-mechanics GET https://markdownregistry.com/api/v1/blob/0f12950688f411c29d6443163fc3a95379109dadc515ecc9407e0eb1aa91dfa6
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.