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.
Excellent operational content: fully executable CLI commands, a validated staged-rollout workflow with user checkpoints and rollback paths, and dense non-inferable Vercel specifics. The two weaknesses are duplicated advice between the Rate limit section and Best practices, and a monolithic ~305-line file that keeps reference-grade detail (operators, condition types, traffic dimensions) inline instead of offloading it to one-level-deep reference files.
Suggestions
Move the reference-grade material — operators, condition types, rate-limit flags, and the traffic-querying dimensions — into a references/ file (e.g., references/cli-reference.md), keeping SKILL.md as the workflow + best-practices overview with clearly signaled links.
Deduplicate the repeated guidance: state the 'start generous (5–10×) with --rate-limit-action log, then tighten' advice and the 'fingerprints collide with real users' warning once (Best practices) and reference it from the Rate limit section.
Trim the repeated 'blocked for agents/scripts due to severity' flagging by consolidating the three agent-blocked commands into the existing 'Don't run commands the CLI blocks for agents' bullet, keeping inline only a one-word pointer per section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Almost every line carries Vercel-specific, non-inferable facts (draft/publish staging semantics, plan gates like "over 600 Enterprise only", "Counters are per region", persistent-action caveats) with no generic-concept padding. Falls short of anchor 5 due to genuine duplication: "collide with real users far more often than they look like they will" appears in both the rollout bullet and the Don't-over-block bullet, and the "5–10× the expected legitimate rate" + "--rate-limit-action log" advice appears in both the Rate limit section and Best practices. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands throughout: complete JSON condition payloads ("--condition '{\"type\":\"path\",\"op\":\"inc\",\"value\":[\"/wp-admin\",\"/.env\"]}'"), exact flags with value ranges ("--rate-limit-window\" seconds 10–3600, "--rate-limit-requests 1–10,000,000"), and even the dashboard URL construction with where to find team/project slugs (".vercel/project.json (`orgSlug` / `projectName`)"). Matches anchor 5's fully-executable, common-cases-covered standard. | 5 / 5 |
Workflow Clarity | The staged rollout is a clearly sequenced 4-step process (Log everywhere → user reviews dashboard traffic → Block in preview first → Block in production) with explicit validation checkpoints between stages ("Have them confirm only the intended traffic is matching", "Re-check the dashboard URL filtered by rule ID") and rollback paths ("roll back with `--action log` or `rules disable`"). This is a destructive-capable, production-affecting domain and the required feedback loops are present, so the ≤3 cap for missing validation does not apply; it matches anchor 5. | 5 / 5 |
Progressive Disclosure | The single SKILL.md runs ~305 lines with zero bundle files — no references/, scripts/, or assets/ exist — so all content is inline. Section structure is good and navigable, but bulk reference material sits inline where the rubric expects splitting: the operators list ("eq/neq (equals), sub (contains), pre (starts-with)…"), the condition-type taxonomy, the rate-limit flag reference, and the traffic-dimension listings. That matches anchor 3 ("content that should be separate is inline") rather than anchor 4, which expects the bulk of reference detail in a separate file. | 3 / 5 |
Total | 17 / 20 Passed |