Content
96%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Excellent operational skill content: an explicit plan/diff/apply workflow with confirmation gates, blocker handling, and error-recovery loops, all stated in concrete, executable terms with no filler. The only structural improvement would be splitting the per-store pricing rules into a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and every sentence carries non-obvious API/domain facts (plan/apply model, one-active-plan limit, amount_micros, start_date requirements for approved subscriptions, per-store pricing quirks). It assumes Claude's competence — no space is spent explaining what App Store Connect or pricing are — matching the 5 anchor; the 4 anchor would require identifiable over-explanation that could be trimmed, and none is present. | 5 / 5 |
Actionability | Guidance is fully executable: exact tool names (`get-product-store-state`, `create-product-store-state-plan`), precise field paths (`store_state.base_plans[<id>].other_regions_config.usd_price`), concrete review/progress URLs, CLI commands (`rc products show <product-id> --store-state`), and specific limits (name ≤ 30 characters, description ≤ 45). The 5 anchor's copy-paste-ready, common-case coverage is met. | 5 / 5 |
Workflow Clarity | The six-step write flow is clearly sequenced with explicit validation checkpoints: inspect first, poll plan to a terminal status, a hard user-confirmation gate before apply, never apply past item-level blockers ("re-plan until there are no item-level blockers"), poll apply to `applied`/`apply_errored`, and error-recovery feedback loops (retry re-runs only unapplied items; start a new plan if the store changed). This matches the 5 anchor including feedback loops for a destructive/batch operation, so no cap applies. | 5 / 5 |
Progressive Disclosure | No bundle files exist, so the skill is a single well-organized file with clear sections (Reads, Prerequisites, Confirm before applying, write flow, Gotchas, CLI equivalents) and appropriately deferred details ("Refer to the MCP tool schemas (or `rc commands --schemas --json`) for exact parameters"). It misses the 5 anchor because at ~85 lines the dense per-store pricing rules (App Store, Play, RC Billing) are inlined where a reference file could carry them; the simple-skill 5 exception applies only under 50 lines. | 4 / 5 |
Total | 19 / 20 Passed |