Content
75%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.
A strong, terse CLI reference with excellent command coverage, clear sequencing, and useful decision guidance versus bundled tools. The main gaps are non-runnable Functions commands missing function_id, minor duplication across Tips/Troubleshooting, and reference-shaped tables inlined in the single file.
Suggestions
Make the Functions workflow fully runnable by showing the function_id argument, e.g. 'notte functions run --function-id <function_id>' and 'notte functions schedule-set --function-id <function_id> --cron "0 */2 * * *"'.
Deduplicate the Lightpanda '--headless=false' caveat and the '@B3 wrong element' fallback — keep each in one place (Troubleshooting) and drop the repeats.
Consider moving the page-actions cheat sheet and environment-variable table into a references/ file to slim the main SKILL.md body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is command-dense with tables and copy-paste blocks and assumes Claude's competence, but has trimmable redundancy — the Lightpanda '--headless=false' caveat appears in the stealth flags table, Tips, and Troubleshooting, and the '@B3 wrong element' advice is duplicated. | 4 / 5 |
Actionability | Mostly executable copy-paste commands throughout (quick start, vault, agents, page actions), but the flagship Functions workflow shows 'notte functions run', 'schedule-set', and 'fork' without the required function_id argument, so those commands are not runnable as written. | 4 / 5 |
Workflow Clarity | Multi-step flows are clearly sequenced (capture → create → run/schedule; start → goto → observe → scrape → stop) with error-recovery guidance in Tips and Troubleshooting, though checkpoints are advisory rather than embedded as explicit validate-before-proceeding steps. | 4 / 5 |
Progressive Disclosure | No bundle files exist, and the single-file skill is well organized with clear section headers; the page-actions cheat sheet, env-var table, and troubleshooting table are defensible inline but are reference-shaped content that could be split out. | 4 / 5 |
Total | 16 / 20 Passed |