Content
85%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 highly actionable and well-structured with strong workflows and excellent progressive disclosure into verified reference files. Its main weakness is conciseness: the length and repetition of safety/status reminders push it below the lean anchor.
Suggestions
Consolidate repeated auth-status definitions and REPL ('nlm chat start') warnings into a single authoritative section and reference it, rather than restating each in multiple categories.
Trim verb-first alias callouts to one summary line per command group instead of repeating both 'source rename' and 'rename source' forms throughout.
Move the long server-configuration / conversation-cache env-var tables (section 16) into a dedicated reference file, keeping only the essentials inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient command tables and code blocks, but at ~980 lines it carries notable repetition (auth-status explanations, REPL warnings, and verb-first aliases each restated several times) and some prose that restates upstream behavior, fitting the 'could be tightened' anchor rather than the lean one. | 3 / 5 |
Actionability | Provides extensive copy-paste-ready nlm CLI commands with concrete flags, MCP tool call examples, and a per-artifact options table — fully executable guidance covering the common cases. | 5 / 5 |
Workflow Clarity | A decision tree plus numbered Common Patterns give a clear sequence, and destructive/batch operations have explicit validation checkpoints (ALWAYS ASK USER BEFORE DELETE, --confirm gates, poll studio_status) with feedback loops for error recovery. | 5 / 5 |
Progressive Disclosure | SKILL.md is a clear overview with well-signaled, one-level-deep references — six real reference files (studio-prompting-guide, studio-prompt-examples, command_reference, troubleshooting, workflows, remote-mcp) confirmed present and listed in an Advanced Reference section — with bulk detail appropriately split out. | 5 / 5 |
Total | 18 / 20 Passed |