Content
71%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 unusually actionable orchestration body: the docs-.md convention, live index table, and decision tree give Claude an exact executable procedure with strong validation loops for the risky design and migration paths. It is dragged down by token-heavy single-paragraph mode bullets that duplicate runbook content inline, and by referencing eight sibling files (plus two parent-directory files) that are not shipped in the bundle being evaluated.
Suggestions
Move the inline runbook detail out of SKILL.md - the ~350-word styling-depth paragraph, the AI-mode bullet, and the workplace/Liquid-Glass paragraph each restate content that design-matching.md / ai-integration.md / custom-ui.md carry; replace them with 1-2 line routing summaries plus the one decision rule that must be read before routing.
Ship the referenced bundle files inside the skill directory: RULES.md, setup.md, push.md, docs-map.md, ai-integration.md, design-matching.md, custom-ui.md, and sendbird-migration.md are all cited as "read before writing any code" but none exist in the bundle, and two references (../stream/sendbird-data-migration.md, ../stream/ai-backend-contract.md) point outside the skill directory entirely.
Break the giant mode/classification paragraphs into short bullets or a routing table (mode -> trigger phrases -> runbook), and add an explicit build-and-verify checkpoint to the plain integrate path so it matches the verification rigor the design-matching path already has.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence (no beginner concept explanations) but is noticeably over-padded: the AI-mode bullet, the styling-depth paragraph, and the workplace/Liquid-Glass paragraph are 200-350-word single sentences that inline pitfall detail already carried by design-matching.md and ai-integration.md, and the closing section re-describes every runbook already referenced above. This is anchor 3 ("mostly efficient but... could be tightened") rather than 4 because the duplicated runbook-level detail is more than a minor trim. | 3 / 5 |
Actionability | Every step of the core loop is executable and copy-paste ready: the docs convention ("take the page URL, drop the trailing /, add .md" with a worked example), the four live index URLs in a table, the numbered lookup procedure with a hard limit ("Fetch at most 3 pages per request"), the citation format ("Source: [Title](https://getstream.io/...)"), and an escalation path naming exact files (ViewFactory.swift, DefaultViewFactory.swift, Options/*.swift). Specific examples cover the common cases of each mode, which is the top anchor despite the skill being instruction-only. | 5 / 5 |
Workflow Clarity | Sequencing is explicit (Step 0 classify product/framework/mode -> UI strategy decision -> Step 1 docs lookup -> Setup) and the risky operations carry genuine validation loops: "not done until you build, run, seed data that triggers every region, compare region-by-region... and iterate", per-screen "design + functional fidelity" verification for migrations, and the never-answer-from-training-data self-check. It sits at anchor 4 rather than 5 because plain integrate/how-to paths defer verification entirely to runbooks with no inline build-and-confirm checkpoint. | 4 / 5 |
Progressive Disclosure | References are one level deep and clearly signaled with purpose statements, but a large share of runbook-level content is inlined in SKILL.md instead of living solely in the referenced files, and none of the referenced bundle files (RULES.md, setup.md, docs-map.md, design-matching.md, custom-ui.md, sendbird-migration.md, ai-integration.md, push.md) are present in the skill directory as provided - nor are the two ../stream/ cross-directory files - so the navigation cannot actually resolve. That combination of inline duplication and unverifiable references fits anchor 3 rather than 4. | 3 / 5 |
Total | 15 / 20 Passed |