Content
43%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.
The content pairs one genuinely useful, executable component example with a large block of inlined agent-configuration metadata and generic best-practice reminders Claude already knows. It lacks any sequenced workflow or validation guidance for the destructive/platform-specific operations it mentions.
Suggestions
Move the agent-config YAML block (triggers/capabilities/constraints/hooks) out of the SKILL.md body into a separate referenced file so the overview stays lean.
Cut platitudes Claude already knows ('use hooks', 'test on both platforms') and replace with specific, non-obvious guidance (e.g. Metro cache invalidation, pod install ordering).
Add a short workflow with validation checkpoints for platform-specific/native-module changes, since the constraints already flag these as confirmation-required.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body inlines a ~140-line YAML agent-config block (triggers, capabilities, constraints, hooks) plus best-practice platitudes Claude already knows ('Use functional components with hooks', 'Test on both iOS and Android'); only the single code example earns its tokens. | 2 / 5 |
Actionability | The 'Component patterns' section provides a complete, executable JSX example with hooks, navigation, StyleSheet and Platform.select; coverage is limited to one component pattern, leaving minor gaps. | 4 / 5 |
Workflow Clarity | There is no real workflow — only a numbered list of responsibilities and bullet best practices — and no sequencing or validation checkpoints for risky operations like native-module or permission changes. | 2 / 5 |
Progressive Disclosure | Section headers (## Key responsibilities, ## Component patterns, etc.) give some structure, but the large inlined YAML spec and absence of any external reference files leave organization mediocre. | 3 / 5 |
Total | 11 / 20 Passed |