Content
85%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.
A highly actionable, well-sequenced operational skill: concrete commands, explicit validation checkpoints, recovery loops, and stop-and-ask conditions. Its main structural weakness is that it is entirely self-contained — ~270 lines with deep troubleshooting material (§3.6, device control, quick-reference duplication) inlined that would be better split into reference files — plus some repeated guidance that costs tokens.
Suggestions
Move the §3.6 stale-code gotchas (EAS build cache and gradle UP-TO-DATE details) into a references file (e.g. references/android-release-verification.md), keeping only the two symptom log lines and a pointer in SKILL.md.
De-duplicate repeated guidance: state 'prefer the project's custom scripts over npx defaults' once (§1.1) and remove the restatements in §1.2, and consolidate the test-clarification instructions currently repeated in §5.2 and the closing line.
Trim or slim the Quick Reference table to entries not already shown verbatim in the body (e.g. keep tool names, drop repeated npx commands), or fold §3.5's device-control table into it since they cover the same tools.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is command-and-table dense with almost no explanation of concepts Claude already knows, fitting the 4 anchor ('efficient; minor instances of over-explanation that could be trimmed'). Trimmable redundancy exists: the 'use the project's custom start script if one exists' guidance is stated three times (§1.1, §1.2 item 2, §1.2 item 4), the `argent-test-ui-flow` pointer appears twice in §5, the test-clarification guidance appears in both §5.2 and the closing line, and the Quick Reference table re-lists commands already given inline. It is not 5 for these duplicated tokens, but well above the 3 anchor's 'unnecessary explanation'. | 4 / 5 |
Actionability | Fully executable guidance throughout: exact commands (`lsof -i :PORT`, `adb -s <serial> reverse tcp:8081 tcp:8081`, `cd ios && pod install --repo-update`, `detox build --configuration ios.sim.release`), tool invocations with named parameters (`boot-device` with `udid`/`avdName`, `reinstall-app` with UDID, bundle ID, .app path), and detection commands like comparing bundle mtime via `ls -la apps/mobile/android/app/build/generated/...`. Placeholders are substitution parameters, not pseudocode, and common cases (iOS, Android, flavored builds, cache staleness) are covered — the 5 anchor. | 5 / 5 |
Workflow Clarity | Clear sequencing with explicit validation checkpoints and feedback loops: verify Metro readiness via `debugger-status` before running the app, ordered recovery steps ('Order of operations (simplest first)'), a stop condition ('After 2-3 failed build or run attempts, STOP and ask the user'), symptom → detection → fix loops for stale-build gotchas, and checklists after each phase. Destructive operations (kill Metro, `rm -rf build Pods Podfile.lock`) are gated behind user confirmation and `stop-metro` confirmation requirements, so the destructive-operation cap does not apply. This matches the 5 anchor ('explicit validation steps; feedback loops for error recovery; checklists'). | 5 / 5 |
Progressive Disclosure | The skill has no bundle files at all — everything lives in a ~270-line SKILL.md. Cross-skill pointers are well signaled (a Related Skills table plus inline mentions), but content that clearly belongs in a separate reference is inlined: §3.6's ~28 lines of EAS-build-cache and gradle UP-TO-DATE gotchas is specialized troubleshooting detail, and §3.5's device-control table plus the Quick Reference command table substantially overlap. This fits the 3 anchor ('some structure but... content that should be separate is inline'); it is not 4 because there are no reference files to offload the deep material into, and not 2 because section structure and navigation within the file are genuinely good. | 3 / 5 |
Total | 17 / 20 Passed |