Content
73%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 exceptionally actionable — every command family has executable syntax, flags, and validation gates for destructive operations, and workflows are clearly sequenced with error-recovery loops. Its weakness is token efficiency: a 1160-line body carries duplicated sections, inline version-history paragraphs, and server-operator detail that the existing reference files were created to hold.
Suggestions
Move the version-specific paragraphs (v0.15.3 login completion, v0.15.4 headless refresh, v0.15.5 refresh safety, the 0.6.14 conversation-cache bounds and startup-flags material) into references/troubleshooting.md and references/remote-mcp.md, leaving one-line pointers in SKILL.md.
Delete the duplicated "Renaming Resources" section — the source-rename commands already appear in Section 3 (Source Management) — and consolidate the MCP-vs-CLI surface guidance that currently appears in both "Tool Detection" and "Critical Rules".
Trim the inline per-command listings to the most common commands and defer full signatures to references/command_reference.md, which already exists for exactly that purpose.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 1160-line body is noticeably verbose with several padded or duplicated sections: the "Renaming Resources" section repeats `nlm source rename`/`nlm rename source` commands already shown in Section 3; inline version changelogs ("Login completion (v0.15.3+)", "Headless refresh & CDP port fallback (v0.15.4+)", "Refresh safety (v0.15.5+)", the 0.16.0 experimental and 0.6.14 cache sections) embed time-sensitive version detail outside any deprecation section; and server-operator material (conversation-cache bounds tables, cache-stats JSON, startup flags, the full 43-extension list) is inlined. This matches the score-2 anchor ("several unnecessary explanations or padded sections") rather than 3 (only some tightening needed); it avoids a 1 because it never explains concepts Claude already knows — nearly all lines are tool-specific commands and behavior notes. | 2 / 5 |
Actionability | Commands are copy-paste ready with exact flags for every family (e.g. `nlm audio create <id> --format deep_dive --length default --confirm`, `nlm research start "query" --notebook-id <id> --mode deep`), MCP signatures include parameter names and allowed values (e.g. `studio_create` options table, `source_sync_drive(source_ids=[...], confirm=True)`), and env vars, status values, and error remediations are all concrete. This fully matches the score-5 anchor: specific executable examples cover the common cases. | 5 / 5 |
Workflow Clarity | Multi-step processes are explicitly sequenced with validation checkpoints: a surface-selection decision tree, a Workflow Decision Tree mapping user intent to command sequences, end-to-end Common Patterns, and an Error Recovery table giving fix-retry feedback loops. Destructive and batch operations carry explicit gates ("⚠️ ALWAYS ASK USER BEFORE DELETE", `--confirm`/`confirm=True` requirements, "Check aliases before creating", "Check plan usage before quota-limited work"), so the destructive/batch cap of 3 does not apply — validation is present, matching the score-5 anchor. | 5 / 5 |
Progressive Disclosure | All six bundle files (studio-prompting-guide.md, studio-prompt-examples.md, command_reference.md, troubleshooting.md, workflows.md, remote-mcp.md) exist, are one level deep, and are clearly signaled in an "Advanced Reference" section with per-file descriptions plus working inline links (Workflows 15/16/17 in workflows.md and the troubleshooting anchor all resolve). However, the body inlines large blocks that belong in those references — near-complete command listings duplicating command_reference.md and auth-recovery internals overlapping troubleshooting.md — which is more than the "minor organization gaps" of the score-5 anchor but better than the muddled structure of 3. | 4 / 5 |
Total | 16 / 20 Passed |