Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured reference skill: lean, competent body with concrete MCP tool calls, a clear verified workflow, and excellent one-level-deep progressive disclosure with all referenced files present. The main weakness is verbosity in the Reference Index, which previews content that belongs in the reference files.
Suggestions
Tighten each Reference Index bullet to a single short clause stating only what the file covers; move the sub-topic enumerations (e.g., the six runtime-solutions sub-topics, the eight module-level-deps declarations) into the reference files themselves.
Trim the runtime-solutions and module-level-deps index entries in particular, since they currently duplicate content the reader will get when opening those references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence (no concept primers or fluff), but the Reference Index previews detailed per-file content — e.g., the runtime-solutions bullet enumerates six sub-topics (Java-facet settings, <runtime>-block wiring, jar-as-stubs, the no-MCP-tool caveat, the Kaja example) — that could be tightened and left to the references. | 2 / 3 |
Actionability | It names concrete MCP tools with parameters (mps_mcp_model_used_language with kind = language or devkit, mps_mcp_create_module type="solution", mps_mcp_get_project_structure startingPoint=<module>) and gives a concrete dependency-vs-used-language decision rule, which is specific, actionable guidance for a reference skill. | 3 / 3 |
Workflow Clarity | The Common Workflow is a clear four-step sequence (Inspect → Diagnose → Apply → Rebuild) with an explicit rebuild verification checkpoint ("Rebuild the module so MPS re-reads the descriptor") and an explicit error-recovery step ("Diagnose the symptom against the pitfalls table"). | 3 / 3 |
Progressive Disclosure | The body is an overview with a well-signaled one-level-deep Reference Index; all nine referenced local files (accessory-models, extends-vs-uses, model-level-imports, module-creation, module-info-fields, module-level-deps, module-rename, pitfalls, runtime-solutions) exist and are clearly described, giving easy navigation. | 3 / 3 |
Total | 11 / 12 Passed |