Content
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is a lean, highly actionable command reference with clean sectioning, but destructive and batch operations lack explicit validation feedback loops.
Suggestions
Add a brief validate/verify step after destructive and batch operations (e.g., confirm a trashed page is gone with `ntn pages get` before proceeding).
For bulk block insertion, show how to confirm the appended blocks succeeded before relying on them.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and command-first, assuming Claude's competence; it avoids explaining concepts Claude already knows and every section earns its place. | 3 / 3 |
Actionability | It provides fully executable `ntn` and curl commands with concrete flags and copy-paste-ready examples across pages, data sources, files, and workers. | 3 / 3 |
Workflow Clarity | Operations are grouped by command area, but destructive or batch operations like `pages trash`, file uploads, and bulk block PATCHes lack explicit validate-then-verify feedback loops, capping clarity at 2. | 2 / 3 |
Progressive Disclosure | With no bundle files present, the single well-organized file with clearly labeled sections (Setup, Pages, Data sources, Raw API, etc.) meets the bar for a simple, self-contained skill. | 3 / 3 |
Total | 11 / 12 Passed |