Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is highly actionable with executable commands and clear workflows, and is well-structured into navigable sections. Its main weakness is progressive disclosure — everything lives inline in one long file rather than being split across reference files — with minor conciseness padding.
Suggestions
Move the page-actions cheat sheet, stealth-flag table, environment variables, and troubleshooting table into one or more reference files (e.g. `references/page-actions.md`, `references/troubleshooting.md`) and link to them from SKILL.md.
Trim the "Why this matters for Bitterbot" prose and the "Agents are cheaper..." aside to keep the overview lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient — commands, tables, and flag references — but includes unnecessary prose such as the "Why this matters for Bitterbot" bullets and "Agents are cheaper than authoring step-by-step CLI calls," which could be trimmed. Not score 3 because of this explanatory padding. | 2 / 3 |
Actionability | It provides fully executable bash and curl commands that are copy-paste ready (e.g. `notte functions create --file workflow.py`, the curl invocation), plus concrete flag and page-action cheat sheets. | 3 / 3 |
Workflow Clarity | The Functions section lays out a clear numbered deploy/run/schedule sequence, and the troubleshooting table plus "Stop sessions you start" tip provide error-recovery feedback loops; no destructive/batch validation is required here. | 3 / 3 |
Progressive Disclosure | Sections are well-organized, but the skill is a single monolithic ~200-line file with no external references, and content that could be split out (page-action cheat sheet, stealth flags, env vars, troubleshooting) is inline. Not score 3 because no references exist and the file exceeds the under-50-line simple-skill carve-out. | 2 / 3 |
Total | 10 / 12 Passed |