Content
88%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.
An exemplary operational skill: concrete tool invocations, a rigorously sequenced workflow with validation and feedback loops, and honest-measurement guidance throughout. The only real weaknesses are redundancy across sections (annotation math, next-steps, and re-profile guidance each stated 2-3 times) and a main file that is denser than a pure overview.
Suggestions
Deduplicate repeated guidance: state the annotation offsetMs formula once (Step 3), and let the §3 'After analysis' and 'After fixes' guidelines be referenced by the steps rather than restated in Step 5, Step 8, and the caveats.
Move the Step 6 drill-down examples and Step 7 session-reload details into a references/query-tools.md, keeping SKILL.md as a leaner overview that links one level deep.
Trim table cells that restate policy (e.g., the react-profiler-status row and the debugger-connection caveat cover the same ground) into a single recovery section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence — no explanation of what React Native or profiling is — and packs tool tables, mode names, and parameter syntax densely. It falls short of anchor 5 because of repeated content: annotation offset math appears in both Step 1 and Step 3, 'ask about next steps' in §3 and Step 5, 'always re-profile' in §3, the caveats, and Step 8, and `react-profiler-status` usage is stated twice. Not anchor 3 — the padding is redundancy, not background explanation. | 4 / 5 |
Actionability | Guidance is fully executable: exact tool names with parameters ('react-profiler-analyze with port, device_id, project_root, platform, and rn_version'), concrete query chains ('profiler-cpu-query mode=component_cpu component_name=AppNavigator', 'profiler-commit-query mode=by_index commit_index=38'), explicit formulas (offsetMs = timestampMs - startedAtEpochMs) and even numeric noise thresholds ('under ~10-15%'). These are copy-paste-ready invocations covering the common cases. | 5 / 5 |
Workflow Clarity | An 8-step ordered workflow with explicit validation checkpoints: save startedAtEpochMs, warn when fiber_renders_captured: 0, check buildMode/strictMode metadata, call react-profiler-status after interruption, honest before/after comparison after fixes, and revert if no net benefit. Error-recovery feedback loops are present throughout (status tool for debugger drop, flow self-improvement on replay failure, iterative drill-down with re-evaluation). | 5 / 5 |
Progressive Disclosure | Structure is good: a single one-level-deep reference (references/diagnostic-tools.md, which exists and is relevant) is clearly signaled, and the flow-replay and native-profiling details are delegated to sibling skills. It misses anchor 5 because the main file carries substantial detail that could be split out — full drill-down query recipes (Steps 6-7) and the query-tool parameter examples in §3 would fit naturally in references, leaving SKILL.md as a tighter overview; navigation within the long body relies on numbered sections that occasionally overlap. | 4 / 5 |
Total | 18 / 20 Passed |