Content
86%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 body is a lean, highly actionable runbook: exact commands, paths, env vars, and failure-mode branches (broken worktree entry, missing Canvas Draw Element flag, Preferences integrity warning) with a real externalized build script. The main improvement opportunities are de-duplicating the repeated Chrome version requirement and adding a post-load verification checkpoint.
Suggestions
State the "Chrome 157.0.8080.0 or newer with Canvas Draw Element enabled" requirement once (e.g., in a short Requirements note) instead of repeating the version string in the rebuild, dev, and reload sections, so the time-sensitive number has a single place to update.
Add a verification step at the end of "Reload in Chrome" — e.g., confirm the extension card shows the durable path with no Errors button before proceeding — to close the feedback loop on the load/reload workflow.
In "Prepare a shot", state how to confirm the WebMCP tools (setup_shot/get_shot) actually appeared in the tab before handing off to the user, giving the final workflow the same checkpoint discipline as the others.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly every sentence carries non-obvious operational facts (durable directories, profile paths, env vars, the extension-ID-change warning, the --enable-blink-features anti-pattern) with no padding of concepts Claude already knows. It falls at "efficient; minor instances ... that could be trimmed" rather than 5 because the time-sensitive version string "Chrome 157.0.8080.0 or newer" is repeated three times instead of stated once. | 4 / 5 |
Actionability | Everything is executable: the exact script invocation with arguments (".agents/skills/canvas-capture-extension/scripts/rebuild-extension.sh --repo <remotion-checkout>"), absolute install paths, the dev command "bun run dev", exact env vars with example values (CANVAS_CAPTURE_HANDOFF_ORIGIN, CANVAS_CAPTURE_BROWSER_EXECUTABLE), chrome:// URLs, flag names, and the files to confirm. Copy-paste ready commands cover the common cases, matching the top anchor. | 5 / 5 |
Workflow Clarity | Each workflow is clearly sequenced with numbered steps, an explicit post-build validation checkpoint ("Confirm that the installed directory contains manifest.json, background.js, ..."), and conditional recovery branches in the reload section ("If Remotion Canvas Capture already points to the durable directory, click Reload" / "If Chrome shows the deleted worktree path, remove that broken entry..."). It stops short of 5 because there is no checkpoint verifying the extension actually loaded cleanly (e.g., no errors on chrome://extensions) after Load unpacked/Reload. | 4 / 5 |
Progressive Disclosure | The body is a well-sectioned overview that delegates the entire build logic to the real one-level-deep bundle script scripts/rebuild-extension.sh (verified to exist and to match the documented behavior), and inlines nothing that belongs in a separate file. Navigation via the four section headers is easy, matching the anchor "clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation". | 5 / 5 |
Total | 18 / 20 Passed |